YuE2-Comfy

YuE2-Comfy Model Bundle

本仓库包含多种上游许可：YuE2 资源以 CC BY-NC 4.0 为主，CSD 社区训练示例为 CC BY-NC-SA 4.0，RVC 资源另带上游使用协议。请以各目录内的许可文件和逐文件 manifest 为准。

完整版整合包

完整版整合包：夸克网盘下载 · Hugging Face 下载 v1.5.4 · SHA-256

Windows / NVIDIA 完整包，包含统一运行环境、YuE2 / RVC / Seed-VC / MuLaCover 全部基础模型。完整解压后，双击 YuE2-T8.exe 即可启动。Hugging Face 镜像路径：bundles/Yue2-T8-Onekey-v1.5.4-Windows-NVIDIA.rar；首次启动可通过页面“检查更新”安装最新的小型代码补丁。

GitHub Release 仅提供代码与自动更新附件，不包含 Python 或模型。完整整合包从上方夸克网盘获取；模型和可选 GGUF 权重也可通过下方网盘单独下载。旧版升级涉及统一运行环境迁移时，更新器会按需另外下载依赖。

模型网盘

模型网盘：夸克网盘下载

模型放置方式见下方“放置路径 / Model placement”。

本地 LLM 模型（可选）

本地 LLM 模型：夸克网盘下载。

用于独立 WebUI 的“AI 创作助手”生成歌词、曲风和可选 ABC。使用 API 无需下载。使用本地模式时，解压模型，在助手设置中填写存放 GGUF 的目录（例如 E:\LLM），保存后选择模型并测试连接；目录留空则使用模型根目录下的 LLM 文件夹。该下载独立于音乐模型包，不是运行 YuE2 的必选项。

这是 ComfyUI YuE2 T8 的完整离线模型仓库，包含 YuE2-3B、YuE2-Vae、SheetSage2、MERT-v2-FullSong、Seed-VC、Demucs、RVC、YuE2-training、MuLaCover、HeartCodec、Qwen3 Embedding、符号转录器以及离线乐谱渲染资源。当前模型树包含 YuE2 风格训练所需的 regularizer-safe-v1 缓存和根目录 MuLaCover 清单；安装器会固定到经过验证的模型提交。

This is the complete offline model repository for ComfyUI YuE2 T8. It also contains the MuLaCover generation model, HeartCodec, Qwen3 embedding model and symbolic transcription checkpoints used by the integrated remix workspace and the native Comfyui-Mulacover-T8 nodes.

v1.5.0 MuLaCover 重新编曲

v1.5.0 可从参考歌曲或 MIDI 提取旋律、和弦与鼓，结合歌词和 topic / genre / instrument / mood 曲风字段重新生成完整歌曲。界面支持参考试听、整曲与旋律独立移调、后台进度、取消恢复、跨页面持久化、音频与三类 MIDI 下载，以及将结果继续发送到 RVC / Seed-VC 换音色。

独立的 Comfyui-Mulacover-T8 提供 8 个进程内原生节点，不依赖本地 Web 服务，也不通过 HTTP 桥接。模型下载完成后，整合包和原生节点可共用同一模型根目录。

v1.4.12 本地音乐工作台、RVC 与 YuE2 风格训练

本地工作室统一使用一个 Python 3.12.10 / Torch 2.10.0 + CUDA 12.8 运行环境，覆盖歌曲生成、转谱、Seed-VC、RVC 训练/推理及可选 GGUF 助手。使用 API 不需要下载本地 LLM；完整包已带 GGUF 后端，权重和模型目录按需选择。

“我的音色 / 训练”提供素材导入与试听、分离伴奏、训练预检、进度日志、取消续训、检索索引和音色库。翻唱区可直接转换已有歌曲，也可使用 YuE2 生成后再转换；Seed-VC / RVC 同曲对比共用分轨缓存，结果在当前页和历史页均可试听。RVC 需要训练或导入目标音色模型，少量轮次的流程测试不代表音色质量。

RVC 额外底模现已镜像在本仓库的 RVC/，并继续按 代码清单 校验。安装器当前仍从 lj1995/VoiceConversionWebUI 固定提交下载；HF 镜像没有改变程序的下载源。RVC 底模只提供训练和推理基础，目标音色仍需用户训练或导入。

YuE2 风格训练资源位于 YuE2-training/，与已有 YuE2-3B、YuE2-Vae、MERT 和 Demucs 一起使用。它训练的是歌曲风格 LoRA；RVC 训练的是歌声音色，两者不能互相替代。regularizer-safe-v1/ 现在随模型仓库提供，包含 codec.npy、offsets.npy 和 metadata.json，新安装无需先本地生成该缓存。

v1.4.11 对完整歌曲使用可复现的 768-token 语义窗口（约 30 秒）训练，同一首歌会在不同步数覆盖不同段落；验证固定检查开头、中段和结尾，并继续保持歌曲级隔离。这样长歌在 24GB GPU 上也能以可接受速度训练，不会因整首长序列的平方级注意力开销卡住数分钟。

v1.4.12 会完成设定的训练步数，但自动发布歌曲级验证损失最低的检查点；模型元数据同时记录完成步数、入选步数和入选验证损失，避免后段过拟合权重覆盖更好的中间模型。

RVC 可显示训练素材的主要音域估计，并独立选择半音或高低八度。默认保留原调；高音失真时可对照低八度和关闭检索的效果。低八度会改变演唱音高，伴奏不移调；若要保持原来的演唱音高，应选择覆盖该音域的训练素材或其他音色。音域统计不是模型能力的硬性边界，导入音色可能没有此统计。同曲对比中该设置只影响 RVC，结果会标出实际移调。

已有 v1.2.2 及以上版本可在首页运行环境卡点击“检查更新”，更新器会准备统一运行时并迁移，启动失败时回滚。更早版本请在新目录解压完整版并设置已有模型路径，不要仅覆盖代码。

API Key 获取：贞贞平价 AI 小屋 · 贞贞的 AI 工坊。渠道有默认模型、可编辑模型 ID 与模型 LIST 获取入口。

放置路径 / Model placement

通过 ComfyUI Registry 安装 yue2-t8 后，默认模型根目录为 ComfyUI/custom_nodes/yue2-t8/models。也可以在 WebUI 展开“模型位置与安装说明”选择其他硬盘，或运行 configure_models.bat。所选路径本身就是模型根目录，应保持以下结构：

ComfyUI/custom_nodes/yue2-t8/models/YuE2-3B/model.safetensors
ComfyUI/custom_nodes/yue2-t8/models/YuE2-Vae/model.safetensors
ComfyUI/custom_nodes/yue2-t8/models/SheetSage2/model.safetensors
ComfyUI/custom_nodes/yue2-t8/models/MERT-v2-FullSong/model.safetensors
ComfyUI/custom_nodes/yue2-t8/models/SheetSage2/render_assets/
ComfyUI/custom_nodes/yue2-t8/models/Seed-VC/DiT_seed_v2_uvit_whisper_base_f0_44k_bigvgan_pruned_ft_ema_v2.pth
ComfyUI/custom_nodes/yue2-t8/models/Demucs/955717e8.safetensors
ComfyUI/custom_nodes/yue2-t8/models/RVC/hubert_base/pytorch_model.bin
ComfyUI/custom_nodes/yue2-t8/models/RVC/rmvpe.pt
ComfyUI/custom_nodes/yue2-t8/models/RVC/pretrained_v2/
ComfyUI/custom_nodes/yue2-t8/models/YuE2-training/tokenizer_head_joint_v4.pt
ComfyUI/custom_nodes/yue2-t8/models/YuE2-training/nar_lora_joint_v4.pt
ComfyUI/custom_nodes/yue2-t8/models/YuE2-training/minted_regularizer_pack.pt
ComfyUI/custom_nodes/yue2-t8/models/MuLaCover/model-00001-of-00005.safetensors
ComfyUI/custom_nodes/yue2-t8/models/HeartCodec-oss/model-00001-of-00002.safetensors
ComfyUI/custom_nodes/yue2-t8/models/Qwen3-Embedding-0.6B/model.safetensors
ComfyUI/custom_nodes/yue2-t8/models/SymbolicTranscriptor/yourmt3/last.ckpt
ComfyUI/custom_nodes/yue2-t8/models/SymbolicTranscriptor/chord/
ComfyUI/custom_nodes/yue2-t8/models/YuE2-training/regularizer-safe-v1/codec.npy
ComfyUI/custom_nodes/yue2-t8/models/YuE2-training/regularizer-safe-v1/offsets.npy
ComfyUI/custom_nodes/yue2-t8/models/YuE2-training/regularizer-safe-v1/metadata.json
ComfyUI/custom_nodes/yue2-t8/models/MODEL_MANIFEST.json
ComfyUI/custom_nodes/yue2-t8/models/VOICE_MODEL_MANIFEST.json
ComfyUI/custom_nodes/yue2-t8/models/MULACOVER_MODEL_MANIFEST.json

If the repository was cloned manually, replace yue2-t8 with the actual node directory name. Keep all twelve model directories, the three root manifests, the RVC and YuE2-training manifests, configuration files, tokenizers, licenses, renderer assets and the three regularizer-safe-v1 files together. Placing only the weight files in ComfyUI/models/checkpoints will not work. The selected path is saved in settings.json and is shared by the WebUI, ComfyUI nodes and native MuLaCover nodes.

自动安装：在节点目录运行 install_runtime.bat。手动下载示例：

hf download t8star/YuE2-Comfy --local-dir ComfyUI/custom_nodes/yue2-t8/models

下载到其他硬盘：

.\install_runtime.bat -ModelsDirectory "D:\AI\YuE2-models"

Contents and provenance

All four weights were verified against the upstream Git LFS SHA256 values before upload.

Seed-VC and Demucs add 24 pinned files listed in VOICE_MODEL_MANIFEST.json (2,574,547,539 bytes total). Every file size and SHA256 was verified before upload. Reference-voice cover support uses these files for local vocal separation, voice conversion, and 48 kHz stereo remixing.

RVC adds 17 pinned files (1,570,504,713 bytes) listed in RVC/MODEL_MANIFEST.json. They come from lj1995/VoiceConversionWebUI revision e6d0c1a17da07c33557852f9dfa2bd44cc75737d. The fixed upstream package agreement is preserved in RVC/使用需遵守的协议-LICENSE.txt.

YuE2 style training adds three pinned files (413,810,275 bytes) listed in YuE2-training/MODEL_MANIFEST.json. The tokenizer head and NAR companion come from Mothersuperior/yue2-mothersuperior-realaudio-tokenizer-v4 revision f2278a2e005dc4ecc421c53a0929f62b3aeb2280; the regularizer pack comes from Mothersuperior/yue2-minted-corpus revision 5d00559c3daa5cfb7a61fbe32158c8c08f9b5f35.

社区训练示例 / Community trained examples

Community-Models/CSD-Korean-Female-v1/ 提供配套完整包可直接使用的两个非商业训练示例：一个可导入“我的音色 / 训练”的 RVC v2 48 kHz 音色包，以及一个仅支持 COT=off 的 YuE2 rank-16 AR 歌曲风格 LoRA。目录同时提供原创新歌词试听、训练报告、逐文件 SHA256、数据摘要、署名和完整许可。

本次 CSD YuE2 示例完成 800 步训练，自动选择歌曲级验证损失最低的第 200 步 checkpoint（3.832125）作为发布 adapter；RVC 示例完成 100 轮训练并包含检索索引。

训练来源为 CSD v1.1 中一位未署名的韩国职业女歌手，不是高允贞。CSD 衍生模型和示例按 CC BY-NC-SA 4.0 提供，仅限非商业用途；未修改的 Mothersuperior NAR companion 保持 CC BY-NC 4.0，RVC 模型另受目录内上游协议约束。原始 CSD 音频没有上传到本仓库。

Links

• GitHub node: https://github.com/T8mars/Comfyui-YuE2-T8
• Native MuLaCover nodes: https://github.com/T8mars/Comfyui-Mulacover-T8
• Latest release / 最新发布: https://github.com/T8mars/Comfyui-YuE2-T8/releases/latest
• ComfyUI Registry: https://registry.comfy.org/nodes/yue2-t8
• Bilibili: https://space.bilibili.com/385085361
• YouTube: https://www.youtube.com/@T8star-Aix/
• API: https://api.seedance.nz/sign-up?aff=5f4w
• 在线 AI 应用 / Online AI apps: https://www.runninghub.ai/zh-cn/user-center/1907375370302308353/userPost?inviteCode=rh-v1121
• ComfyUI 整合包 / Portable package: https://pan.quark.cn/s/264edb7e36bd
• Hugging Face profile: https://huggingface.co/t8star

License

YuE2 first-party code and weights and the YuE2-training companion resources use CC BY-NC 4.0 and are limited to non-commercial use. The RVC upstream model package includes its own research-use agreement; read RVC/使用需遵守的协议-LICENSE.txt. Each model directory keeps its upstream license and third-party notices. SheetSage2 and MERT retain their respective upstream license files.