music-tag-auto 1.0.0

LLM-powered CLI for batch music metadata tagging

music-tag-auto

由 music-tag-web 衍生的批量音乐标签命令行工具。

把识别和选择的工作交给 llm

安装

pip install music-tag-auto
music-tag-auto --help

Quickstart:

export OPENAI_API_KEY=
export OPENAI_MODEL=gpt-4.1-mini
export OPENAI_BASE_URL=https://your-openai-compatible-api
music-tag-auto tag /path/to/musicdir

常用参数：

• --dry-run：只搜索和选择，不写入标签
• --output-dir ./tagged-output：默认把打完标签的副本输出到目标目录，并保留原相对目录结构
• --in-place：直接覆盖源文件，不生成副本
• --limit 10：最多处理 10 首
• --report-file result.json：指定报告输出路径
• --source acoustid：启用指纹识别源，要求本机已安装 fpcalc
• --llm-base-url https://your-openai-compatible-api：指定 llm 基础 url
• --llm-api-key "$OPENAI_API_KEY"：指定 llm api key
• --llm-model gpt-4.1-mini：指定 llm 模型

也支持环境变量：

• OPENAI_BASE_URL
• OPENAI_API_KEY
• OPENAI_MODEL

netease 源需要登录态

• NETEASE_COOKIE
• NETEASE_COOKIE_FILE

发布

构建：

uv build

上传到 PyPI：

uv publish

或者使用 twine：

python -m twine upload dist/*