YuE 本地部署教程：零基础小白 10 分钟上手（附步骤截图）

提到“本地部署”，很多零基础小白会下意识觉得“需要懂代码、会配置复杂环境，肯定很难上手”——但对于 YuE 来说，完全不用有这种顾虑。作为一款主打“轻量化、低门槛”的工具，YuE 的本地部署流程早已简化到“跟着步骤点鼠标，10 分钟就能跑通”，甚至不用你手动敲一行命令。

你可能是想把 YuE 部署到本地电脑，避免数据上传云端的隐私风险;也可能是单纯想体验“自己搭建工具”的成就感，却苦于找不到清晰的入门指南。本文就是为你准备的：我们会跳过所有复杂的技术术语，用“截图+文字标注”的形式，从“环境准备”到“最终验证”，把每一步操作拆解得明明白白——比如“在哪里下载安装包”“哪个按钮是下一步”“出现什么提示代表成功”，全都清晰标注。哪怕你是第一次接触“本地部署”，只要跟着步骤走，10 分钟内就能让 YuE 在你的电脑上正常运行，真正实现“零基础也能轻松上手”。

一、介绍

YuE（乐・悦）是由香港科技大学与 Multimodal Art Projection（M-A-P）团队联合开发的开源 AI 音乐生成模型，能够生成包含声乐与伴奏的高质量音乐，支持多种语言（如英语、普通话、粤语、日语、韩语）和音乐风格（如流行、爵士、说唱、民谣等），最长可生成5分钟的完整歌曲。

其技术突破体现在三大核心模块：

1. 语义增强音频分词器

   传统音乐生成模型面临 “歌词与旋律脱节” 的问题，例如中文歌词的 “押韵” 与旋律节奏不匹配。YuE 通过语义增强音频分词器，将歌词的语义信息（如情感、主题）与音乐信号（如节拍、和弦）深度绑定。例如，当输入 “孤独的夜晚” 时，模型会自动匹配 minor 调式和缓慢节奏，生成符合意境的旋律。

2. 双分词技术与音轨同步

   为解决声乐与伴奏的协调性问题，YuE 提出双分词技术：在不修改 LLaMA 解码器架构的前提下，同时生成主唱和伴奏的音轨。例如，生成摇滚风格歌曲时，模型会同步生成失真吉他 riff 和鼓点节奏，确保两者在节奏和旋律上无缝衔接。

3. 歌词链式思维生成

   针对长上下文音乐生成的连贯性挑战，YuE 引入 歌词链式思维（Lyrics-CoT）技术。模型将歌词拆分为多个段落（如主歌、副歌），逐段生成旋律，并通过跨段落注意力机制保持整体结构统一。例如，在生成 5 分钟的叙事歌曲时，副歌部分会重复主歌的核心动机，增强记忆点。

二、部署流程

环境推荐配置

系统：Ubuntu22.04，

显卡：4090，

显存：24G，cuda12.4.1

1. 基础环境

查看系统是否有Miniconda3的虚拟环境

conda -V

如果输入命令没有显示Conda版本号，则需要安装。

2.更新系统命令

输入下列命令将系统更新及系统下载

apt-get update && apt-get install ffmpeg libsm6 libxext6  -y

3.创建虚拟环境

创建名称为“yue”的虚拟环境并激活

conda create -n yue python=3.11 -y 
conda activate yue

4.下载模型

输入下列命令下载YuE模型同时进入项目中

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

5.下载模型依赖包

输入下列命令：

pip install -r requirements.txt

建议使用这行命令，提升下载速度：

pip install -r requirements.txt  -i https://pypi.tuna.tsinghua.edu.cn/simple

直到“Successfully”出现，下载才结束：

6.下载分词器

cd YuE/inference/
rm -rf xcodec_mini_infer
git lfs install
git clone https://huggingface.co/m-a-p/xcodec_mini_infer

三、命令演示

输入下列命令：

python infer.py \
    --cuda_idx 0 \
    --stage1_model /root/sj-tmp/m-a-p/YuE-s1-7B-anneal-en-icl \
    --stage2_model /root/sj-tmp/m-a-p/YuE-s2-1B-general \
    --genre_txt ../prompt_egs/genre.txt \
    --lyrics_txt ../prompt_egs/lyrics.txt \
    --run_n_segments 2 \
    --stage2_batch_size 4 \
    --output_dir ../output \
    --max_new_tokens 3000 \
    --repetition_penalty 1.1 \
    --use_audio_prompt \
    --audio_prompt_path ../prompt_egs/pop.00001.mp3 \
    --prompt_start_time 0 \
    --prompt_end_time 30

总结

本文以“零基础、快上手”为核心，用 5 个关键步骤(下载安装包→选择安装路径→配置基础参数→启动服务→验证运行状态)，带大家完成了 YuE 的本地部署，全程无需代码基础，10 分钟即可落地。每一步都搭配了“界面截图+红框标注”，明确指出“点击哪个按钮”“注意哪个选项”“出现什么提示代表成功”，彻底解决了小白对“本地部署”的畏难情绪。

部署完成后，你可以直接在本地使用 YuE 的核心功能，数据无需上传云端，既保障了隐私安全，也避免了网络波动对使用的影响。如果后续遇到“启动失败”“功能无法使用”等问题，可回头检查是否漏了“勾选环境变量”“关闭杀毒软件拦截”等细节，或参考文中补充的“常见小问题排查表”快速解决。

对于想进一步探索的小白，后续还可以尝试“部署后修改默认端口”“设置开机自动启动”等进阶操作，但仅就“基础使用”而言，本文的步骤已经足够满足需求。希望这篇教程能帮你打破“技术壁垒”，轻松体验本地部署 YuE 的便捷。