https://github.com/billwuhao/ComfyUI_ACE-Step
ACE-Step: A Step Towards Music Generation Foundation Model
https://github.com/billwuhao/ComfyUI_ACE-Step
Last synced: 7 days ago
JSON representation
ACE-Step: A Step Towards Music Generation Foundation Model
- Host: GitHub
- URL: https://github.com/billwuhao/ComfyUI_ACE-Step
- Owner: billwuhao
- License: apache-2.0
- Created: 2025-05-07T11:40:39.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-05-26T15:30:48.000Z (23 days ago)
- Last Synced: 2025-05-26T16:52:30.106Z (23 days ago)
- Language: Python
- Homepage:
- Size: 1.64 MB
- Stars: 126
- Watchers: 1
- Forks: 6
- Open Issues: 27
-
Metadata Files:
- Readme: README-CN.md
- License: LICENSE
Awesome Lists containing this project
- awesome-comfyui - **ComfyUI_ACE-Step** - Step: A Step Towards Music Generation Foundation Model (All Workflows Sorted by GitHub Stars)
README
[中文](README-CN.md)|[English](README.md)
# ACE-Step 的 ComfyUI 节点
快速, 高质量音乐生成, "重绘", Remix, 编辑, 扩展等, Windows, Linux, Mac 应该都支持(未做完整测试).
## 📣 更新
[2025-05-14]⚒️:
- 支持 Lora, 将 [ACE-Step-v1-chinese-rap-LoRA](https://huggingface.co/ACE-Step/ACE-Step-v1-chinese-rap-LoRA) 下载放到 `models\TTS\ACE-Step-v1-3.5B\loras` 目录下.
```
loras
└─ACE-Step-v1-chinese-rap-LoRA
config.json
pytorch_lora_weights.safetensors
```
- 增加很多美味的参考歌曲参数.
[2025-05-12]⚒️: 增加模型加载节点, 可自定义模型加载. 感谢 @[thezveroboy](https://github.com/thezveroboy) 的贡献. 增加 `cpu_offload`, 8g 显存可用, 速度更快.
[2025-05-10]⚒️: 增加歌词语言转换节点, 为 [ComfyUI](https://docs.comfy.org/tutorials/audio/ace-step/ace-step-v1) 官方版 ACE-Step 工作流提供多语言支持.
[2025-05-07]⚒️: 发布版本 v1.0.0.
## 使用
- Lora:
增加了多语言转换节点, 为 [ComfyUI](URL_ADDRESS.comfy.org/tutorials/audio/ace-step/ace-step-v1) 官方版 ACE-Step 工作流提供多语言支持. 目前，ACE Step 支持 19 种语言，但以下 10 种语言有更好的支持：
- 英语：[en]
- 中文：[zh]
- 俄文：[ru]
- 西班牙文：[es]
- 日文：[ja]
- 德文：[de]
- 法文：[fr]
- 葡萄牙文：[pt]
- 意大利文：[it]
- 韩文：[ko]
- 生成:
- "重绘":
- 扩展:
- 编辑:
- 自动生成歌词, prompt, 暂停工作流, 修改然后点击 `continue workflow` 继续工作流 [example](workflow-examples/ACE-gen-automated-composition.json). 可用最新的 Gemini, Qwen3, 以及 DeepSeek v3.:
## 安装
```
cd ComfyUI/custom_nodes
git clone https://github.com/billwuhao/ComfyUI_ACE-Step.git
cd ComfyUI_ACE-Step
pip install -r requirements.txt
# python_embeded
./python_embeded/python.exe -m pip install -r requirements.txt
```
## 模型下载
https://huggingface.co/ACE-Step/ACE-Step-v1-3.5B
模型手动下载放到 `models\TTS\ACE-Step-v1-3.5B` 目录下, 结构如下:
```
ACE-Step-v1-3.5B
│
├─ace_step_transformer
│ config.json
│ diffusion_pytorch_model.safetensors
│
├─music_dcae_f8c8
│ config.json
│ diffusion_pytorch_model.safetensors
│
├─music_vocoder
│ config.json
│ diffusion_pytorch_model.safetensors
│
└─umt5-base
config.json
model.safetensors
special_tokens_map.json
tokenizer.json
tokenizer_config.json
```
## 鸣谢
[ACE-Step](https://github.com/ace-step/ACE-Step)