YuE 生态精选 · 集成、工具、界面、模型、教程与最佳实践
A curated list of YuE ecosystem resources: integrations, tools, UIs, models, tutorials and best practices.
简体中文 | English
YuE（乐）是 m-a-p 团队开源的全曲音乐生成基础模型（lyrics2song），可以只凭歌词与风格提示生成几分钟长的完整歌曲（人声 + 伴奏），被视为开源版 Suno。自 2025 年 1 月发布以来，社区涌现了大量界面、量化加速、ComfyUI 节点、本地移植与音乐制作工作流。本仓库旨在把 YuE / YuE2 生态的优秀项目、集成与最佳实践收录成一份持续维护的中文优先清单。
YuE (乐) is an open-source full-song music generation foundation model by the m-a-p team (lyrics2song) — often called "open-source Suno". Since its release in January 2025 the community has built a rich ecosystem of UIs, quantized runtimes, ComfyUI nodes, local ports and music-production workflows. This repo curates the best of the YuE / YuE2 ecosystem.
📊 收录 70+ 个项目 · 最近更新 2026-09-26 · 每季度巡检链接有效性 📌 收录标准与提交方式见 贡献指南。分类排序大致按热度/活跃度，仅供浏览参考。 📌 See CONTRIBUTING.md for inclusion criteria. Categories are loosely ordered by popularity/activity.
- 快速选择 Quick Picks
- 官方资源 Official
- 图形界面 GUI
- 量化与推理加速 Quantization & Acceleration
- 平台适配与本地移植 Platform and Local Ports
- ComfyUI 集成 ComfyUI Integrations
- 音乐制作工具链 Music Production Toolchain
- 云部署与服务化 Cloud & Serving
- 教程与最佳实践 Tutorials & Best Practices
- 相关项目 Related Projects
- 社区 Community
- 贡献 Contributing
不知道从哪儿开始？按你的硬件和需求直接对号入座，一行搞定。
| 你的情况 | 直接去 |
|---|---|
| 只想先听听效果 | NOIZ 在线 Demo — 浏览器免费试玩，不用装环境 |
| Windows，想开箱即用、100% 离线 | RevolutionLA/YuE2-Music-Workbench — 写歌 + 翻唱 + RVC 换声 + LRC 歌词 + 批量队列 |
| 显存 24GB+，要最好音质 | 官方 YuE2 BF16 + 官方 Skill |
| 显存 16GB | exl2 / INT8 量化权重 |
| 显存 8GB | deepbeepmeep/YuEGP 或 YuE-UI 量化模式 |
| Mac（Apple Silicon） | vanch007/mlx-Yue 或 tonywestonuk/YuE-Studio |
| iPhone 上直接出歌（不连服务器） | PocketAnthem — App Store 应用，YuE2-3B 经 MLX 全程跑在手机本地 |
| 想在 ComfyUI 里用 | ComfyUI 原生 YuE2GenerateMusic 节点，见 ComfyUI 集成 |
| 想改乐谱 / 保留旋律换歌词 | timoncool/YuE2-Studio（五线谱）· FL-YuE2（钢琴卷帘） |
| 要跑云端 / 需要 API | sruckh/Yue2-runpod · yue2-sidecar（FastAPI） |
| 不想装 Python 环境 | yue2.cpp — 单个 C++ 可执行文件，v0.1.0 起有现成二进制下载 |
| 项目 | 说明 | 备注 |
|---|---|---|
| multimodal-art-projection/YuE | YuE / YuE2 官方仓库。YuE2 引入符号规划（ABC 可编辑乐谱）、零样本翻唱与 agentic 音乐编辑，质量对标 Suno v5 | Apache-2.0 |
| YuE2 官网 | YuE2 项目主页，含在线试听 Demo | — |
| NOIZ 在线 Demo | 浏览器免费试玩 YuE2，无需安装（官方 README 推荐） | 在线服务 |
| Blizaine/Maestro | 本地歌曲生成/作曲规划/翻唱，内置 YuE2（官方 README 推荐） | — |
| YuE1 Demo 页 | YuE 首代模型演示页 | — |
| arXiv:2503.08638 | 论文《YuE: Scaling Open Foundation Models for Long-Form Music Generation》 | 2025.03 |
| m-a-p on Hugging Face | 全部官方权重：YuE-s1-7B（en/zh/jp-kr × cot/icl）、YuE-s2-1B、YuE2-3B、YuE2-Vae、YuE-upsampler 等 | — |
| Comfy-Org/YuE2 | ComfyUI 官方合作的一体化 checkpoint（yue2_3b_bf16.safetensors，约 7.8 GB） |
ComfyUI 专用 |
| 官方文档 docs/generation.md | YuE2 生成指南：SongRequest / GenerationConfig / 符号乐谱编辑 / 产物与可复现性 |
— |
| 官方内置 Skill：yue2-music | 官方随仓库提供的 Agent Skill（含 ABC 编辑参考与 run_yue2.py 脚本） |
— |
YuE2 架构速览：2.2B AR 语言模型负责歌曲规划与语义 token（
full/melody/off三种 CoT 模式）→ 1.5B NAR flow-matching 分支生成 64 通道 VAE latent → 48 kHz 立体声 VAE 解码输出；支持 vLLM 加速、CUDA Graph、权重 offload。
图形界面，一键/低门槛出歌。
| 项目 | 说明 | 平台 | 备注 |
|---|---|---|---|
| ⭐ RevolutionLA/YuE2-Music-Workbench | 本地 AI 音乐生成工作站：YuE2 写歌 + AI 翻唱 + RVC 换声 + LRC 滚动歌词 + 批量队列，100% 离线开箱即用 | Windows | 特别推荐 |
| timoncool/YuE2-Studio | 本地 AI 歌曲生成器，带可编辑乐谱（五线谱） | Windows/Linux | MIT |
| deepbeepmeep/YuEGP | YuEGP：专为"显卡穷人"优化（GPU Poor），MMGP 显存管理 | Linux/Win | YuE 官方 README 推荐 |
| joeljuvel/YuE-UI | Gradio 界面：批量生成、时间线可视化、增量续写、会话保存/加载，8GB 显存可跑（量化模型） | 跨平台 | YuE 官方 README 推荐 |
| sgsdxzy/YuE-exllamav2 | ExLlamaV2 加速实现（含 GUI），YuE1 时代最高效的推理方案之一 | Linux/Win | Apache-2.0 |
| alisson-anjos/YuE-exllamav2-UI | 基于 YuE-exllamav2 的 Gradio UI，RTX 4090 实测端到端 5.45× 提速；提供 Docker 镜像 | Linux/Win/Docker | Apache-2.0 |
| alisson-anjos/YuE-Interface | Docker 化 Gradio 界面，环境变量一键拉取全部官方/量化模型，本地与 RunPod 均可部署 | Docker/RunPod | — |
| WrongProtocol/YuE-exllamav2-UI | YuE-exllamav2 的原始 Gradio UI（官方 README 推荐） | Linux/Win | — |
| vrgamegirl19/Yue2_Studio | YuE2 桌面音乐工作室 | Windows | Apache-2.0 |
| krakenunbound/yue2-studio | 原生 Windows 音乐工作室：本地模型下载、歌词/封面编辑 | Windows | — |
| Ladypoly/YuE2_WebUI | YuE2 WebUI | — | Apache-2.0 |
| dynamohum/YuE2gen-studio | 翻唱录音 / 提示词写歌 / 编辑的 Web 界面 | — | Apache-2.0 |
| Mozer/YuE-extend | YuE1 音乐续写（mp3 extend）+ GUI，另有 Colab 版 | 跨平台 | Apache-2.0 |
| CodeCat04/Whiskerwave-Studio | 本地优先的 YuE2 生成 GUI + Ollama 辅助作词 | — | — |
| DocShotgun/ds-yue-webui | YuE2 WebUI：生成 / 翻唱 / 编辑 | — | — |
| aidec/YuE-exllamav2-GUI-easy | YuE-exllamav2 简易版 GUI（繁体中文界面） | Windows | — |
| LeeAeron/YuE2UI | YuE2 桌面应用（深度改版独立开发，暂未公开源码） | Windows 10/11 | Apache-2.0 |
显存不足时的量化方案与吞吐优化。
| 项目 | 说明 | 备注 |
|---|---|---|
| NoizAI/YuE2-Turbo | YuE2 高并发推理与在线服务工具包：同模型同配方，单首 1.68× 提速、并发 3.31× 提升 | Apache-2.0 |
| Alissonerdx exl2 量化权重 | YuE-s1-7B 的 ExLlamaV2 全系列量化（3.0–8.0 bpw） | HF Collection |
| Doctor-Shotgun/YuE-s1-7B-anneal-en-cot-exl2 | exl2 量化权重（Q8/Q6 等） | HF |
| Alissonerdx/YuE-s1-7B-anneal-en-cot-int8 | bitsandbytes INT8 量化权重 | HF |
| VincentGOURBIN/yue2-mlx-packs | YuE2-3B 的 MLX 预量化包（int4-mixed-head 2.5 GB / qint8-all-head 3.5 GB / int4-head 4.4 GB），引擎下载时 SHA-256 校验 | HF |
| ServeurpersoCom/yue2.cpp | GGML C++17 便携实现：文本+歌词进，48kHz 立体声出 | MIT |
| engival/yue2.cpp | YuE2 的 ggml/Vulkan 实现：单个 C++ 可执行文件，无需 Python（v0.1.0 起提供二进制下载）；实验特性：编辑 context 窗口，可在曲中指定位置换 prompt/风格（演示） | MIT |
Mac（MLX / Core ML）与 Windows / Linux 的原生运行与一键安装，按平台分组。
| 项目 | 说明 | 备注 |
|---|---|---|
| tonywestonuk/YuE-Studio | 原生 Mac 应用，面向 Apple Silicon（GPU + Neural Engine）调优 | Apache-2.0 |
| vanch007/mlx-Yue | YuE2-3B 的 Apple Silicon MLX 原生移植（含音频转写） | Apache-2.0 |
| ianiv/YuE2 | YuE2 Studio：Apple Silicon（MLX）上的本地 Web 应用 | MIT |
| VincentGourbin/yue2-mlx-swift | Swift/MLX 移植（Mac + iPhone 全本地）：歌词+风格 → 完整歌曲，App Store 应用 PocketAnthem 的引擎，7 个参考量化配置（4bit-tiny 2.6 GB 起） | MIT |
| daig/yue2-mlx | BF16 优先的 MLX/MPS 实验，自动跟随上游 | Apache-2.0 |
| arinltte/YuE2Mac | macOS 原生歌曲创作工作室：YuE2-3B 本地 MLX 运行，LITE/PRO 双 UI、队列、歌曲库、草稿→成品、可编辑 ABC 乐谱、高级采样、Apple Intelligence 本地 AI 写词 | MIT |
| smittyPNW/YuE-Studio | Apple Silicon 本地创作/编辑/母带，全质量 YuE2 生成与可逆音频处理 | Apache-2.0 |
| stavitian/yue2-studio | macOS 应用 + 安装器：YuE2-3B 生成/翻唱/转写（含 24GB Mac 修复） | — |
| sdbds/YuE-for-windows | YuE1 Windows 原生支持（Gradio + Docker） | Apache-2.0 |
| Cognito-Inc-451/Yue2-CUDA-Windows | YuE2 CUDA Windows 适配 | — |
| siliconsense/yue2-studio-pc | 一键批处理在 NVIDIA 显卡上运行 YuE2（生歌 + 翻唱） | — |
| Rdx-ai-art/yue2-mlx.pinokio | YuE2-3B 的 Pinokio 一键安装包（Mac MLX） | — |
| deadjoe/yue2_groove | 非官方 YuE2 Web UI（Apple Silicon 优先，Linux/CUDA 可用），另有 Pinokio 版 | Apache-2.0 |
| PasiKoodaa/YuE2-Radio | 本地 AI 电台（YuE2 持续播放） | MIT |
| Joker56156/tio-music-studio | 本地 AI 音乐工作室：ACE-Step 1.5 / YuE / DiffRhythm 集成 | — |
| Arthur031221/songforge | 本地 Suno 式歌曲工作室：Apple Silicon 上用 MLX 运行 YuE2，歌词生成带人声歌曲/翻唱 | MIT |
ComfyUI 已原生支持 YuE2（PR #16250，
yue2分支），以下为社区节点包与相关工作流。
| 项目 | 说明 | 备注 |
|---|---|---|
| ComfyUI 原生支持 | ComfyUI 核心内置 YuE2GenerateABC / YuE2GenerateMusic 等节点（comfy_extras/nodes_yue2.py），使用 Comfy-Org/YuE2 一体化 checkpoint |
官方原生 |
| smthemex/ComfyUI_YuE | YuE1 时代社区最流行的 ComfyUI 节点（Stage A/B 加载器，支持 exl2/INT8 量化） | Apache-2.0 |
| filliptm/ComfyUI-FL-YuE2 | YuE2 音乐生成 + 可编辑钢琴卷帘（piano roll） | Apache-2.0 |
| T8mars/Comfyui-YuE2-T8 | YuE2 ComfyUI 节点包 | — |
| Starnodes2024/ComfyUI-YuE2-Trainer | YuE2 LoRA 训练器：用自己的音轨训练风格 LoRA（NAR 分支，24GB 显存推荐），ComfyUI 原生格式输出 | — |
| ScryptHunter/ComfyUI-YuE2 | YuE2 ComfyUI integration with Native/Legacy workflows, ABC editing and duration control, SheetSage2 support, and universal LoRA/LoKr adapters (AR/NAR).（Native/Legacy 工作流、ABC 编辑与时长控制、SheetSage2 支持、通用 LoRA/LoKr 适配器 AR/NAR） | Apache-2.0 |
| pytraveler/YuE2-ComfyUI | 钢琴卷帘乐谱编辑 + Edit Track（对成品做重录/剪切/移动/延长）+ 音频或 MIDI 翻唱 + 作词与 LoRA 支持 | Apache-2.0 |
| KytraScript/ComfyUI-FS_Audio_Suite | 模块化 YuE2 音频生成节点 + 母带/降噪工作流（含封面生成） | — |
| o-l-l-i/ComfyUI-Olm-YuE2 | 风格+歌词生成歌曲，可选乐谱查看/编辑 | — |
| nvmax/ComfyUI-YuE2 | YuE2 ComfyUI 节点 | Apache-2.0 |
| piscesbody/ComfyUI-YuE2 | YuE2 ComfyUI 节点（ScryptHunter fork 的上游） | Apache-2.0 |
| EmeraldApple-AI/ComfyUI-YuE2 | YuE2-3B lyrics-to-song 自定义节点 | — |
| TheLocalLab/ComfyUI-SongScribe | AI 音乐提示词节点：73 种风格预设 + 歌曲分析（支持 YuE2） | MIT |
| UnlimitedEditing/ComfyUI-YuE2Fast | 运行官方 YuE2 runtime 的快速节点（CUDA Graph 解码） | — |
| cicalooo/ComfyUI-YuE2-LongSong | YuE2 长歌曲生成工作流 | MIT |
| mitnits/yue2-same-music-new-lyrics | 保留旋律、改唱新歌词：Gradio UI + ComfyUI 节点（YuE2 + SheetSage2） | Apache-2.0 |
把 YuE2 接入 DAW、乐谱编辑与音频后期。
| 项目 | 说明 | 备注 |
|---|---|---|
| mikkel/yue2-concept-sliders | 16 个 YuE2 音乐概念滑杆（Concept Sliders），支持 ComfyUI | MIT |
| nheegen/yue2-session-bridge | Ableton Max for Live 设备：Session MIDI 和声 → ABC → YuE2 | MIT |
| o-l-l-i 系工作流 | 乐谱查看/编辑 + 翻唱模式的完整 ComfyUI 工作流示例 | — |
| 项目 | 说明 | 备注 |
|---|---|---|
| yolanother/runpod-yuegp-serverless | RunPod Serverless 上的 YuEGP worker | — |
| lee101/yue-cog | YuE2 的 Cog 打包 + RunPod serverless 适配器 | — |
| sruckh/Yue2-runpod | YuE2 RunPod Serverless worker（风格+歌词 → 完整歌曲） | — |
| Sparaa/yue2-sidecar | FastAPI 任务 API（基于 yue2-infer，支持 ABC 翻唱与长歌） | Apache-2.0 |
| arthurfarache/muvflow-yue | YuE 音乐生成 API（SaladCloud） | — |
| giapnguyen74/yue2-server | YuE2 模型服务器 | — |
| John-yg-Yim/LastAlbum-music-api | 基于 YuE 的 FastAPI 歌曲生成服务（LastAlbum 后端） | — |
| usamireko/YuE-exllamav2-Colab | Google Colab 一键运行 YuE-exllamav2 | Apache-2.0 |
- 官方 Prompt 工程指南：genre.txt / lyrics.txt 写法 — 歌曲分段标签（
[Verse]/[Chorus]）、风格标签顺序等。 - 官方示例工作流视频：Fahd 的 YuE 快速上手视频。
- YuE2 提示词结构：
style放流派/乐器/人声/语言/速度，lyrics放带分段标签的歌词；参考 examples/song.json。 - ICL 翻唱最佳实践（官方 README 摘录）：
- 双轨 ICL（人声轨 + 伴奏轨）音乐性与提示遵循最好；
- 用副歌片段做参考音频效果更佳；
- 约 30 秒参考音频为宜；
- 可用 python-audio-separator 或 UVR 分离音轨；
- 提供参考音频会降低多样性，纯 CoT 模式输出更多样。
- ComfyUI Wiki：YuE2-3B 介绍与原生支持：comfyui-wiki.com/en/news/2026-09-11-yue2-3b — 含 ComfyUI 依赖冲突（PyTorch/Transformers 版本 pin）注意事项。
- DeepWiki：YuE 代码解读：deepwiki.com/multimodal-art-projection/YuE —
YuE2Pipeline架构、AR/NAR/VAE 模块与后端加速的可视化文档。 - 显存速查（社区经验）：24GB+ → 官方 BF16；16GB → exl2/INT8 量化；8GB → YuE-UI 量化模式 / YuEGP MMGP；Mac → MLX 移植。
| 项目 | 说明 |
|---|---|
| ace-step/ACE-Step | 另一个开源音乐生成基础模型，常与 YuE2 对比/搭配（remiqora 把两者集成在同一界面） |
| inikolax/remiqora | 统一 ACE-Step 1.5 与 YuE2-3B 的本地 AI 音乐工作室（Vue） |
| m-a-p/MERT | YuE2 评测所用音乐理解模型（MERT2） |
| SheetSage2 | YuE2 评测所用歌词对齐乐谱模型 |
- GitHub Issues / Discussions — 官方仓库问题与路线图（vLLM/sglang、llama.cpp、stemgen 等）。
- Hugging Face m-a-p 组织 — 权重发布与模型卡。
- map-yue2.github.io — 在线试听 Demo。
欢迎提交 PR！收录标准、格式规范与提交步骤请阅读 CONTRIBUTING.md。中英文说明均可，中文优先。
本清单以 CC0 1.0 发布。所收录项目各自遵循其许可证，使用前请查阅各项目主页。
Made with ❤️ by the YuE community · Inspired by awesome-deepseek-integration & sindresorhus/awesome