从零到首次启动：RVC-WebUI安装部署快速入门指南（Windows/Linux/macOS三平台）

从零到首次启动RVC-WebUI安装部署快速入门指南Windows/Linux/macOS三平台【免费下载链接】rvc-webuiliujing04/Retrieval-based-Voice-Conversion-WebUI reconstruction project项目地址: https://gitcode.com/gh_mirrors/rv/rvc-webuiRVC-WebUI是一款开源的 RVC 语音转换Retrieval-based Voice ConversionWeb 界面项目是 liujing04/Retrieval-based-Voice-Conversion-WebUI 的重构版本。它把训练、推理、分轨等复杂流程做成了浏览器界面新手也能在几分钟内完成安装并跑通第一次推理。本指南覆盖 Windows、Linux、macOS 三平台的一键启动步骤。一、认识 RVC-WebUI它能做什么在动手之前先花 30 秒了解这个项目能帮你避开很多弯路️音色训练用一小段干声人声训练属于自己的音色模型实时/文件推理上传音频用训练好的音色进行语音转换✂️音轨分离内置分轨功能modules/separate.py️纯浏览器操作基于 Gradio 构建的 UI无需安装客户端项目采用脚本 → 启动器 → WebUI的三层结构理解它能让你快速定位问题文件作用webui-user.bat / webui-user.sh用户配置入口可自定义 Python、Git 路径、启动参数webui.bat / webui.sh自动创建并激活虚拟环境再调用启动器launch.py环境准备脚本自动安装 torch、torchaudio 和依赖webui.py真正启动 Gradio Web 界面的入口 官方测试环境Windows 10 Python 3.10.9 torch 2.0.0cu118见 README.md二、部署前准备环境要求清单三大平台共需准备以下工具安装顺序很重要Git— 用于拉取代码与依赖检查Python 3.10推荐版本与测试环境一致PyTorchNVIDIA 显卡建议 cu118 版本Mac 使用系统默认 MPS 后端FFmpeg— 音频处理必需各平台额外注意Windows若后续安装依赖报错Microsoft Visual C 14.0 or greater is required需先安装 Visual Studio 的C Build Tools见 README.md 的 Troubleshooting 章节Linux需要python3-venv包不要以 root 用户运行webui.sh 会直接拒绝macOS项目提供了 webui-macos-env.sh自动设置python3.10、MPS 回退开关等默认值一般无需手动修改三、Windows 一键启动最简单步骤 1获取代码git clone https://gitcode.com/gh_mirrors/rv/rvc-webui进入rvc-webui目录。步骤 2双击启动双击 webui-user.bat 即可。脚本会自动完成检测 Python 与 pip 是否可用webui.bat在venv目录创建/激活虚拟环境webui.bat执行launch.py自动安装 torch 全部依赖launch.py启动 Web 界面launch.py → webui.py首次启动需要下载依赖请耐心等待几分钟。启动成功后浏览器会自动打开地址类似http://127.0.0.1:7860。⚙️ 想自定义参数如指定 GPU、端口只需编辑 webui-user.bat 中的COMMANDLINE_ARGS变量例如set COMMANDLINE_ARGS--port 8080。四、Linux 快速部署步骤 1安装基础工具# Debian/Ubuntu 示例 sudo apt install git python3.10 python3.10-venv ffmpeg步骤 2克隆并启动git clone https://gitcode.com/gh_mirrors/rv/rvc-webui cd rvc-webui bash webui.shwebui.sh 的工作流程读取 webui-user.sh 中的自定义变量检查 Git 与 Python 是否已安装webui.sh创建并激活venv虚拟环境webui.sh执行launch.py完成依赖安装并启动界面⚠️ 若你使用AMD 显卡脚本会自动切换为 ROCm 版 torchwebui.sh其他情况可取消 webui-user.sh 中TORCH_COMMAND的注释来指定 CUDA 版本。五、macOS 启动步骤macOS 与 Linux 共用 webui.sh但会自动加载 webui-macos-env.sh 中的 macOS 默认配置优先使用python3.10webui-macos-env.sh设置PYTORCH_ENABLE_MPS_FALLBACK1启用 Apple Silicon 的 MPS 加速回退webui-macos-env.shgit clone https://gitcode.com/gh_mirrors/rv/rvc-webui cd rvc-webui bash webui.sh 如需调整 macOS 行为请修改 webui-user.sh 而不是 webui-macos-env.sh——后者是只读默认值文件头部注释已明确说明这一点。六、启动后界面长什么样首次成功启动后你会看到几个主要功能页签源码位于 modules/tabs/页签源码功能推理inference.py选择音色 上传音频 → 一键变声训练training.py处理干声 → 训练专属音色模型分轨split.py人声与伴奏分离合并merge.py音轨合并服务端server.py局域网/API 调用新手建议的第一条路径推理页签 → 选择一个预训练音色放入 models/checkpoints/→ 上传一段音频 → 点击转换几分钟内就能听到变声效果。七、常见问题速查FAQ❓启动后浏览器没自动打开手动访问终端中提示的地址默认http://127.0.0.1:7860。可通过--port参数更换端口modules/cmd_opts.py。❓依赖装得太慢或失败国内网络可考虑配置 pip 镜像源依赖清单见 requirements/main.txt核心为 gradio、torch、faiss-cpu、librosa 等。❓显存不够用项目支持--medvram --opt-split-attention等参数见 webui-user.sh 注释示例并可用--precision fp32在 fp16/fp32 间切换modules/cmd_opts.py。❓想拉取更新项目提供了 update.shLinux/mac和 update.batWindows更新脚本。❓模型文件放哪里音色模型放 models/checkpoints/语义嵌入放 models/embeddings/预训练权重放 models/pretrained/训练输出在 outputs/。八、进阶训练你自己的音色跑通推理只是开始。RVC 的核心乐趣在于训练专属音色模型准备 10~30 分钟干声无人声伴奏、无混响人声训练流程会经过切片slicer.py、F0 提取extract_f0.py、特征提取extract_feature.py等步骤采样率配置可按需选择configs/ 下提供了 32k/40k/48k 三档采样率、768 维与常规两套配置如 40k.json、48k-768.json训练逻辑位于 lib/rvc/train.py损失函数见 lib/rvc/losses.py训练产物会自动保存到 models/training/models/之后即可在推理页签中使用你的音色。总结RVC-WebUI 的安装门槛已经被降到了双击脚本的级别Windows双击 webui-user.batLinuxbash webui.shmacOSbash webui.sh自动加载 macOS 优化配置首次启动会自动创建虚拟环境并装好全部依赖耐心等待即可。完成本文后你已经从零走到了第一次听到自己的 RVC 变声接下来就可以深入训练页签打造专属音色了。【免费下载链接】rvc-webuiliujing04/Retrieval-based-Voice-Conversion-WebUI reconstruction project项目地址: https://gitcode.com/gh_mirrors/rv/rvc-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考