Hugging Face's logo

t8star
/
YuE2-Comfy

Safetensors
Chinese
English
comfyui
music-generation
audio
yue2
transcription
Model card Files
xet
 Community

YuE2-Comfy Model Bundle

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

完整版整合包

完整版整合包：夸克网盘下载

Windows / NVIDIA 完整包，包含运行环境与模型。完整解压后，双击 YuE2-T8.exe 即可启动。

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 以及离线乐谱渲染资源。

This is the complete offline model repository for ComfyUI YuE2 T8. It contains the generation model, VAE, transcription model, MERT encoder, Seed-VC reference-voice models, Demucs separation model, RVC training/inference assets, YuE2 style-training companion assets, and offline score renderer assets.

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 pack 在本地生成 regularizer-safe-v1，因此该缓存不在仓库中。

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/MODEL_MANIFEST.json
ComfyUI/custom_nodes/yue2-t8/models/VOICE_MODEL_MANIFEST.json

If the repository was cloned manually, replace yue2-t8 with the actual node directory name. Keep all eight model directories, both root manifests, the RVC and YuE2-training manifests, configuration files, tokenizers, licenses, and renderer assets 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 and ComfyUI 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

Directory Upstream repository Fixed revision SHA256 of model.safetensors
YuE2-3B mrfakename/YuE2-3B 9c7af7677010933b77b159d9dc1a2848c58e26a1 1d55c42c1a9875c34f5d736e15078449992b044e807ce2a138e6cf289a1e59e9
YuE2-Vae m-a-p/YuE2-Vae 95535e72a97bc0f09b8ada125d26b4009428c0e8 807ce9d5149fa27c5ad3e6582058469852e908f6c5acc8c8aa338e7ab7751346
SheetSage2 m-a-p/SheetSage2 eab522a8168e8b8b8c4856bf8609cd86198f01fe b235f68091a5f5b644000f2b5acb57d1e70432aca2b34ab1b9cf27236e1f4274
MERT-v2-FullSong m-a-p/MERT-v2-FullSong d8ba1c745e733b3908ce6ad16ebeb17ac7600a42 e6dd2ab187d6dd62b6521cd7d8f932e237acf0c5757745a7232082e28391350d

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

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.

Downloads last month

-

Downloads are not tracked for this model. How to track
Inference Providers NEW
This model isn't deployed by any Inference Provider. 🙋 Ask for provider support

Model tree for t8star/YuE2-Comfy

Base model

mrfakename/YuE2-3B
Finetuned
(1)
this model