YuE

环境要求

• Linux 操作系统
• Python 3.12
• 支持 BF16 的 NVIDIA GPU
• 至少 24 GB 显存
• 首次运行需联网从 Hugging Face 下载模型

安装与启动步骤

1. 1克隆仓库

   把 YuE 源码克隆到本地，命令执行后会生成 YuE 目录

   git clone https://github.com/multimodal-art-projection/YuE.git

   复制

2. 2进入项目目录

   切换到刚克隆下来的 YuE 目录，后续命令都在此目录执行

   cd YuE

   复制

3. 3创建虚拟环境

   用 Python 3.12 创建独立虚拟环境 .venv，避免污染系统环境

   python3.12 -m venv .venv

   复制

4. 4激活虚拟环境

   激活后终端提示符前会出现 (.venv)，之后的 pip 与 python 均指向该环境

   source .venv/bin/activate

   复制

5. 5升级 pip

   先升级 pip 到最新版，避免旧版本解析依赖出错

   python -m pip install --upgrade pip

   复制

6. 6安装 YuE2

   按当前目录的 pyproject/setup 安装 YuE2 及其依赖，耗时较长请耐心等待

   python -m pip install .

   复制

7. 7生成第一首歌

   运行示例脚本，首次执行时会自动从 Hugging Face 下载模型文件

   python examples/generate.py --output outputs/first-song

   复制

关键配置

如何确认成功

打开 outputs/first-song/audio.flac，能正常播放 48 kHz 立体声歌曲即部署成功。

常见问题

注意事项

• 环境必须是 Linux + Python 3.12 + 支持 BF16 的 NVIDIA GPU（24 GB 显存）。
• YuE2 输出 48 kHz 立体声，不做量化。
• 输出目录除音频外还保留乐谱、语义 token、声学 latent、生成设置和模型标识。
• 除命令行脚本外，也可用 Python 接口 YuE2Pipeline.from_pretrained("m-a-p/YuE2-3B", device="cuda") 调用。