Files
songforge/README.md
T

2.8 KiB
Raw Blame History

songforge

本地 ACE-Step 生歌 CLI:锁定模型与声线 LoRA、铁律前奏注入、歌词密度硬校验、QC 验收。

独立项目:clone 到任意目录,写好 config/local.toml 指向本机 ComfyUI,即可生成。

文档 给谁
AGENTS.md Agent / 自动化
docs/使用手册.md 人类操作

换目录也能用(推荐)

# 1) clone(GitHub 或 Gitea)
cd D:\CodeFiles\ProProjects
git clone https://git.nnrc.ren/swl/songforge.git
cd songforge

# 2) CLI 环境(Python >= 3.11)
.\scripts\setup_venv.ps1

# 3) 本机 ComfyUI 连接(只改这一份)
copy config\local.toml.example config\local.toml
# 编辑:
#   [engine] server = "http://127.0.0.1:8188"
#   [paths]  comfy_root / qc_python / music_dir

# 4) 先起 ComfyUI,再体检
.\.venv\Scripts\python.exe songforge.py doctor

只要 ComfyUI 在跑、local.toml 里 comfy_root 指向正确安装根(含 models/checkpoints 与 LoRA),不必把本仓放进 ComfyUI 的 user/default/workflows。

两个 Python 环境

环境 用途
本仓 .venv CLI:doctor / check / gen / catalog
qc_python QC 音频栈(可继续用 ComfyUI 的 venv)

配置:TOML vs JSON

文件 作用
config/default.toml 算法 / 相对路径(相对本仓根)
config/local.toml 本机 Comfy 根、服务地址、QC Python(gitignore)
workflows/template.json 包内 workflow 图(JSON,与配置分流)
config/baseline/*.json QC 基线数据

优先级:命令行 > SONGFORGE_* > local.toml > default.toml > DEFAULTS

流水线

.\.venv\Scripts\python.exe songforge.py target --style pop --bpm 104 --dur 180
.\.venv\Scripts\python.exe songforge.py check --style pop --title 歌名 --lyrics-file input\lyrics\歌名.txt
.\.venv\Scripts\python.exe songforge.py gen   --style pop --title 歌名 --lyrics-file input\lyrics\歌名.txt
.\.venv\Scripts\python.exe songforge.py qc    --run gen-<时间戳> --baseline

qc 必须带 --baseline。音频写到 ComfyUI output/MyMusic/(可用 music_dir 覆盖)。

硬约束(摘要)

项 值
模型 ace_step_1.5_turbo_swl_fused + swl_voice_best_ep257(0.5/0.5)
采样 shift=5.5 / steps=28 / cfg=2.0 / temperature=0.68
时长 完整歌 150–200 秒
前奏 8 小节器乐 hook;CLI 自动注入

目录

songforge/                 # clone 下来的仓根 = 包根
  config/default.toml
  config/local.toml        # 本机(勿提交)
  data/runs/YYYY-MM-DD/    # gen 产物
  workflows/template.json
  .venv/

远程

License

MIT — 见 LICENSE。