如何通过pip安装RVC的依赖?
安装RVC依赖的完整步骤
RVC(Retrieval-Based Voice Conversion)的依赖安装核心是解决Python版本兼容和PyTorch(带CUDA)的正确安装,以下是分步、可直接操作的教程:
1. 环境准备(避免90%的兼容问题)
RVC对Python版本要求严格,仅支持3.8~3.10(3.11+版本部分依赖库暂不兼容),优先用虚拟环境隔离依赖。
(1)创建并激活虚拟环境
# 创建名为rvc-env的虚拟环境(Windows/macOS/Linux通用)
python -m venv rvc-env
# 激活虚拟环境
# Windows(cmd/powershell)
rvc-env\Scripts\activate
# macOS/Linux
source rvc-env/bin/activate
(2)升级pip到最新版
pip install --upgrade pip
2. 优先安装PyTorch(核心!必须单独装)
RVC依赖PyTorch的CUDA版本(CPU版运行速度极慢),不能直接通过requirements.txt安装(默认装CPU版):
# 推荐:CUDA 11.8版本(适配绝大多数NVIDIA显卡)
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118
# 无显卡/仅CPU(不推荐,仅应急用)
# pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
3. 安装RVC的其余依赖
首先下载RVC项目的requirements.txt(仓库地址:https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI),然后执行:
# 进入RVC项目文件夹(替换为你的实际路径)
cd /path/to/your/RVC-folder
# 国内用户(用清华镜像加速,避免下载超时)
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
# 海外用户
pip install -r requirements.txt
4. 验证安装是否成功
运行以下命令,无报错则安装完成:
# 验证PyTorch的CUDA是否可用(输出True才正常)
python -c "import torch; print(torch.cuda.is_available())"
# 验证RVC核心依赖
python -c "import librosa, fairseq, pyworld; print('所有依赖安装成功')"
常见问题解决
- 安装pyworld/fairseq失败:Windows需先安装「Visual Studio Build Tools」(勾选C++开发工具);Linux需执行
apt install build-essential libsndfile1-dev。 - torch.cuda.is_available()返回False:检查显卡驱动是否安装,重新安装与CUDA版本匹配的PyTorch。
总结
- RVC依赖安装的核心前提是Python 3.8~3.10版本 + 虚拟环境,避免版本冲突。
- PyTorch必须单独安装带CUDA的版本,这是保证RVC正常运行的关键(CPU版几乎无法使用)。
- 国内用户安装依赖时添加清华PyPI镜像,可大幅提升下载速度、避免安装超时。
本文由 RVC-VoiceChanger.top 原创发布,转载请注明出处。