如何通过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('所有依赖安装成功')"

常见问题解决


总结

  1. RVC依赖安装的核心前提是Python 3.8~3.10版本 + 虚拟环境,避免版本冲突。
  2. PyTorch必须单独安装带CUDA的版本,这是保证RVC正常运行的关键(CPU版几乎无法使用)。
  3. 国内用户安装依赖时添加清华PyPI镜像,可大幅提升下载速度、避免安装超时。

本文由 RVC-VoiceChanger.top 原创发布,转载请注明出处。