安装

准备工作复制锚点链接

第一步：创建虚拟环境复制锚点链接

py -3.11 -m venv rvc-next-env
rvc-next-env\Scripts\activate
python -m pip install --upgrade pip

py -3.11 只是示例，换成你已安装的 3.10～3.14 中任一版本即可。之后的所有命令都在激活了该环境的终端中执行。

第二步：安装 PyTorch复制锚点链接

PyTorch 需要按硬件选择对应的构建，所以要先单独安装。版本须为 2.7.1 或更新。按操作系统和显卡在下面选择对应的命令；其他构建见 pytorch.org。

python -m pip install torch==2.14.0 --index-url https://download.pytorch.org/whl/cu130

第三步：安装 RVC Next复制锚点链接

python -m pip install rvc-next

由于 PyTorch 已经装好，pip 会认为 torch 依赖已满足，不会再替换成别的构建。安装完成后，环境中会多出 rvc-next 命令。

转换和实时变声页上的 效果 链（混响、压缩、延迟等）需要 pedalboard，它是可选附加项：

python -m pip install "rvc-next[effects]"

转换页上的 文字转语音 输入需要 tts 附加项（edge-tts，使用微软的在线语音）：python -m pip install "rvc-next[tts]"。附加项可以组合："rvc-next[effects,tts]"。

从源码安装复制锚点链接

如果你想使用最新的代码，或者参与开发，可以从源码安装：

git clone https://github.com/licyk/rvc-next.git
cd rvc-next
python -m pip install -e .

源码中不包含构建好的网页界面（rvc_next/webui/dist 不在仓库里）。没有它时，rvc-next webui 只提供 API，日志中会出现 No web UI build found。构建网页界面需要 bun：

python scripts/dev.py web-install   # 等同于在 rvc_next/webui 中运行 bun install
python scripts/dev.py web           # 构建到 rvc_next/webui/dist

如果要自己打包 wheel，请使用 python scripts/build_wheel.py，它会先构建网页界面再打包；直接运行 python -m build 得到的包里没有网页界面。开发环境的完整搭建见开发环境。

第四步（可选）：实时变声所需的 PortAudio复制锚点链接

实时页面通过 sounddevice 使用 PortAudio 访问声卡。

只做文件转换、分离和训练时不需要 PortAudio。

第五步：验证安装复制锚点链接

rvc-next version

列出 RVC Next、Python 以及 torch、transformers、faiss-cpu、av、sounddevice、pymss 等主要组件的版本；显示 not installed 的组件说明安装不完整。

rvc-next doctor

doctor 做一次全面检查并给出建议：

• 数据文件夹的位置；
• torch 版本与 CUDA 版本，自动选择的计算设备和精度，以及每个设备的显存和是否被采用；
• 是否找到 ffmpeg（不是必需的，PyAV 无需它就能解码）；
• 音频设备是否可用（实时变声需要）；
• 每个资源（HuBERT、RMVPE、底模、分离模型等）的状态和校验结果。

刚安装时，doctor 会提示 HuBERT 和 RMVPE 尚未安装，并给出 rvc-next assets download hubert 这样的命令。这是正常的，下一页会处理它。两个命令都支持 --json 输出。

下一步复制锚点链接

继续阅读首次启动：启动网页界面、下载模型并完成第一次转换。