mirror of
https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI.git
synced 2026-08-29 10:09:32 +02:00
Update Ubuntu setup and multilingual documentation
This commit is contained in:
RVC-Boss
@@ -1,25 +1,23 @@
|
||||
<div align="center">
|
||||
|
||||
<h1>Retrieval-based-Voice-Conversion-WebUI</h1>
|
||||
Uma estrutura de conversão de voz fácil de usar baseada em VITS.<br><br>
|
||||
Um framework simples e fácil de usar para conversão de timbre vocal / alteração de voz.<br><br>
|
||||
|
||||
[](https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI)
|
||||
|
||||
<img src="https://counter.seku.su/cmoe?name=rvc&theme=r34" /><br>
|
||||
|
||||
[](https://colab.research.google.com/github/RVC-Project/Retrieval-based-Voice-Conversion-WebUI/blob/main/Retrieval_based_Voice_Conversion_WebUI.ipynb)
|
||||
[](https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI/blob/main/LICENSE)
|
||||
[](https://huggingface.co/lj1995/VoiceConversionWebUI/tree/main/)
|
||||
|
||||
[](https://discord.gg/HcsmBBGyVk)
|
||||
[](https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI/blob/main/LICENSE)
|
||||
[](https://huggingface.co/lj1995/VoiceConversionWebUI/tree/main/)
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
------
|
||||
[**Changelog**](https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI/blob/main/docs/Changelog_EN.md) | [**FAQ (Frequently Asked Questions)**](https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI/wiki/FAQ-(Frequently-Asked-Questions))
|
||||
[**Changelog**](./Changelog_pt.md) | [**FAQ (Frequently Asked Questions)**](https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI/wiki/FAQ-(Frequently-Asked-Questions))
|
||||
|
||||
[**English**](../en/README.en.md) | [**中文简体**](../../README.md) | [**日本語**](../jp/README.ja.md) | [**한국어**](../kr/README.ko.md) ([**韓國語**](../kr/README.ko.han.md)) | [**Türkçe**](../tr/README.tr.md) | [**Português**](../pt/README.pt.md)
|
||||
[**English**](../en/README.en.md) | [**中文简体**](../../README.md) | [**日本語**](../jp/README.ja.md) | [**한국어**](../kr/README.ko.md) ([**韓國語**](../kr/README.ko.han.md)) | [**Français**](../fr/README.fr.md) | [**Türkçe**](../tr/README.tr.md) | [**Português**](../pt/README.pt.md)
|
||||
|
||||
|
||||
Confira nosso [Vídeo de demonstração](https://www.bilibili.com/video/BV1pm4y1z7Gm/) aqui!
|
||||
@@ -46,124 +44,169 @@ Este repositório possui os seguintes recursos:
|
||||
+ Interface Webui fácil de usar;
|
||||
+ Use o modelo UVR5 para separar rapidamente vocais e instrumentos.
|
||||
+ Use o mais poderoso algoritmo de extração de voz de alta frequência [InterSpeech2023-RMVPE](#Credits) para evitar o problema de som mudo. Fornece os melhores resultados (significativamente) e é mais rápido, com consumo de recursos ainda menor que o Crepe_full.
|
||||
+ Suporta aceleração de placas gráficas AMD/Intel.
|
||||
+ Sistemas AMD/Intel usam as dependências de CPU; Windows pode usar DirectML e Linux usa CPU.
|
||||
|
||||
## Preparando o ambiente
|
||||
Os comandos a seguir precisam ser executados no ambiente Python versão 3.8 ou superior.
|
||||
|
||||
(Windows/Linux)
|
||||
Primeiro instale as dependências principais através do pip:
|
||||
Esta branch é destinada a **Python 3.12 x64**. Execute todos os comandos na raiz do repositório. Ubuntu 24.04 x86_64 é recomendado.
|
||||
|
||||
### Ubuntu 24.04
|
||||
|
||||
```bash
|
||||
# Instale as dependências principais relacionadas ao PyTorch, pule se instaladas
|
||||
# Referência: https://pytorch.org/get-started/locally/
|
||||
pip install torch torchvision torchaudio
|
||||
sudo apt update
|
||||
sudo apt install -y python3.12 python3.12-venv python3.12-dev ffmpeg unzip libsndfile1 libportaudio2
|
||||
|
||||
#Para arquitetura Windows + Nvidia Ampere (RTX30xx), você precisa especificar a versão cuda correspondente ao pytorch de acordo com a experiência de https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI/issues/ 21
|
||||
#pip instalar tocha torchvision torchaudio --index-url https://download.pytorch.org/whl/cu117
|
||||
|
||||
#Para placas Linux + AMD, você precisa usar as seguintes versões do pytorch:
|
||||
#pip instalar tocha torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm5.4.2
|
||||
python3.12 -m venv .venv
|
||||
source .venv/bin/activate
|
||||
python -m pip install --upgrade pip setuptools wheel
|
||||
```
|
||||
|
||||
Então pode usar poesia para instalar as outras dependências:
|
||||
```bash
|
||||
# Instale a ferramenta de gerenciamento de dependências Poetry, pule se instalada
|
||||
# Referência: https://python-poetry.org/docs/#installation
|
||||
curl -sSL https://install.python-poetry.org | python3 -
|
||||
### Windows
|
||||
|
||||
#Instale as dependências do projeto
|
||||
poetry install
|
||||
Instale o Python 3.12 x64 e crie um ambiente virtual:
|
||||
|
||||
```powershell
|
||||
py -3.12 -m venv .venv
|
||||
.venv\Scripts\activate
|
||||
python -m pip install --upgrade pip setuptools wheel
|
||||
```
|
||||
|
||||
Você também pode usar pip para instalá-los:
|
||||
### Escolha de dependências por hardware
|
||||
|
||||
| Hardware | Instalação |
|
||||
| --- | --- |
|
||||
| CPU, AMD, Intel | Use `requirments_cpu_py312.txt`; Windows pode usar DirectML, Linux usa CPU |
|
||||
| NVIDIA RTX série 50 | Instale primeiro o Torch CUDA 12.8 e depois `requirments_cu128_py312.txt` |
|
||||
| NVIDIA anterior à série RTX 50 | Instale primeiro o Torch CUDA 11.8 e depois `requirments_cu118_py312.txt` |
|
||||
|
||||
#### CPU, AMD, Intel
|
||||
|
||||
```bash
|
||||
|
||||
for Nvidia graphics cards
|
||||
pip install -r requirements.txt
|
||||
|
||||
for AMD/Intel graphics cards on Windows (DirectML)：
|
||||
pip install -r requirements-dml.txt
|
||||
|
||||
for AMD graphics cards on Linux (ROCm):
|
||||
pip install -r requirements-amd.txt
|
||||
python -m pip install -r requirments_cpu_py312.txt
|
||||
```
|
||||
|
||||
------
|
||||
Usuários de Mac podem instalar dependências via `run.sh`:
|
||||
#### NVIDIA RTX série 50: duas etapas
|
||||
|
||||
```bash
|
||||
sh ./run.sh
|
||||
python -m pip install torch==2.7.1+cu128 torchaudio==2.7.1+cu128 \
|
||||
--index-url https://download.pytorch.org/whl/cu128 \
|
||||
--extra-index-url https://pypi.org/simple
|
||||
python -m pip install -r requirments_cu128_py312.txt
|
||||
```
|
||||
|
||||
## Preparação de outros Pré-modelos
|
||||
RVC requer outros pré-modelos para inferir e treinar.
|
||||
#### NVIDIA anterior à série RTX 50: duas etapas
|
||||
|
||||
Baixe-os em nosso [Huggingface space](https://huggingface.co/lj1995/VoiceConversionWebUI/tree/main/).
|
||||
|
||||
Aqui está uma lista de pré-modelos e outros arquivos que o RVC precisa:
|
||||
```bash
|
||||
./assets/hubert_base
|
||||
|
||||
./assets/pretrained
|
||||
|
||||
./assets/uvr5_weights
|
||||
|
||||
Downloads adicionais são necessários se você quiser testar a versão v2 do modelo.
|
||||
|
||||
./assets/pretrained_v2
|
||||
|
||||
Se você deseja testar o modelo da versão v2 (o modelo da versão v2 alterou a entrada do recurso dimensional 256 do Hubert + final_proj de 9 camadas para o recurso dimensional 768 do Hubert de 12 camadas e adicionou 3 discriminadores de período), você precisará baixar recursos adicionais
|
||||
|
||||
./assets/pretrained_v2
|
||||
|
||||
#Se você estiver usando Windows, também pode precisar desses dois arquivos, pule se FFmpeg e FFprobe estiverem instalados
|
||||
ffmpeg.exe
|
||||
|
||||
https://huggingface.co/lj1995/VoiceConversionWebUI/blob/main/ffmpeg.exe
|
||||
|
||||
ffprobe.exe
|
||||
|
||||
https://huggingface.co/lj1995/VoiceConversionWebUI/blob/main/ffprobe.exe
|
||||
|
||||
Se quiser usar o algoritmo de extração de tom vocal SOTA RMVPE mais recente, você precisa baixar os pesos RMVPE e colocá-los no diretório raiz RVC
|
||||
|
||||
https://huggingface.co/lj1995/VoiceConversionWebUI/blob/main/rmvpe.pt
|
||||
|
||||
Para usuários de placas gráficas AMD/Intel, você precisa baixar:
|
||||
|
||||
https://huggingface.co/lj1995/VoiceConversionWebUI/blob/main/rmvpe.onnx
|
||||
|
||||
python -m pip install torch==2.7.1+cu118 torchaudio==2.7.1+cu118 \
|
||||
--index-url https://download.pytorch.org/whl/cu118 \
|
||||
--extra-index-url https://pypi.org/simple
|
||||
python -m pip install -r requirments_cu118_py312.txt
|
||||
```
|
||||
|
||||
Em seguida, use este comando para iniciar o Webui:
|
||||
Verifique Torch e CUDA:
|
||||
|
||||
```bash
|
||||
python -c "import torch; print('torch:', torch.__version__); print('cuda:', torch.version.cuda); print('cuda available:', torch.cuda.is_available())"
|
||||
```
|
||||
|
||||
O programa também verifica a memória e a capacidade de computação da GPU NVIDIA. GPUs com aproximadamente menos de 4 GiB ou abaixo de SM 5.3 usam CPU.
|
||||
|
||||
### Fontes de pacotes
|
||||
|
||||
Os três arquivos `requirments_*.txt` definem suas fontes no topo. Para usar fontes oficiais, substitua somente `--index-url` e `--extra-index-url`, mantendo versões, sufixos CUDA e a ordem das duas etapas.
|
||||
|
||||
| Default mirror | Official source |
|
||||
| --- | --- |
|
||||
| `https://mirrors.pku.edu.cn/pypi/simple` | `https://pypi.org/simple` |
|
||||
| `https://mirrors.nju.edu.cn/pytorch/whl/cpu` | `https://download.pytorch.org/whl/cpu` |
|
||||
| `https://mirrors.nju.edu.cn/pytorch/whl/cu118` | `https://download.pytorch.org/whl/cu118` |
|
||||
| `https://mirrors.nju.edu.cn/pytorch/whl/cu128` | `https://download.pytorch.org/whl/cu128` |
|
||||
|
||||
## Modelos e diretórios de execução
|
||||
|
||||
O WebUI cria os diretórios de execução automaticamente. Baixe os modelos do [repositório de modelos Hugging Face](https://huggingface.co/lj1995/VoiceConversionWebUI/tree/main) e mantenha esta estrutura:
|
||||
|
||||
```text
|
||||
assets/
|
||||
├── hubert_base/
|
||||
│ ├── config.json
|
||||
│ ├── preprocessor_config.json
|
||||
│ └── pytorch_model.bin
|
||||
├── rmvpe/rmvpe.pt
|
||||
├── pretrained/
|
||||
├── pretrained_v2/
|
||||
├── uvr5_weights/
|
||||
├── weights/ # user RVC .pth models
|
||||
└── indices/ # user .index files
|
||||
logs/
|
||||
└── mute/ # training silence samples
|
||||
|
||||
# Exact paths used by the code
|
||||
assets/hubert_base/config.json
|
||||
assets/hubert_base/preprocessor_config.json
|
||||
assets/hubert_base/pytorch_model.bin
|
||||
assets/rmvpe/rmvpe.pt
|
||||
assets/pretrained/*.pth
|
||||
assets/pretrained_v2/*.pth
|
||||
assets/uvr5_weights/*
|
||||
assets/weights/*.pth
|
||||
assets/indices/*.index
|
||||
logs/mute/*
|
||||
```
|
||||
|
||||
### Baixar modelos
|
||||
|
||||
```bash
|
||||
python -m pip install --upgrade huggingface_hub
|
||||
|
||||
# Required for inference and feature extraction
|
||||
hf download lj1995/VoiceConversionWebUI --revision main \
|
||||
--include "hubert_base/*" --local-dir assets
|
||||
hf download lj1995/VoiceConversionWebUI rmvpe.pt --revision main \
|
||||
--local-dir assets/rmvpe
|
||||
|
||||
# Required for v1/v2 training
|
||||
hf download lj1995/VoiceConversionWebUI --revision main \
|
||||
--include "pretrained/*" "pretrained_v2/*" --local-dir assets
|
||||
hf download lj1995/VoiceConversionWebUI mute.zip --revision main \
|
||||
--local-dir .model-downloads
|
||||
python -m zipfile -e .model-downloads/mute.zip logs
|
||||
|
||||
# Required only for UVR5 vocal separation
|
||||
hf download lj1995/VoiceConversionWebUI --revision main \
|
||||
--include "uvr5_weights/*" --local-dir assets
|
||||
```
|
||||
|
||||
Ambientes Windows AMD/Intel DirectML também precisam de:
|
||||
|
||||
```bash
|
||||
hf download lj1995/VoiceConversionWebUI rmvpe.onnx --revision main \
|
||||
--local-dir assets/rmvpe
|
||||
```
|
||||
|
||||
O arquivo antigo `hubert_base.pt` não é usado nesta branch. O código atual usa o modelo Transformers em `assets/hubert_base/`. O FCPE está incluído no `torchfcpe`.
|
||||
|
||||
### FFmpeg
|
||||
|
||||
O comando Ubuntu acima instala o FFmpeg. No Windows, coloque estes arquivos na raiz do repositório:
|
||||
|
||||
- [ffmpeg.exe](https://huggingface.co/lj1995/VoiceConversionWebUI/resolve/main/ffmpeg.exe?download=true)
|
||||
- [ffprobe.exe](https://huggingface.co/lj1995/VoiceConversionWebUI/resolve/main/ffprobe.exe?download=true)
|
||||
|
||||
## Iniciar o WebUI
|
||||
|
||||
```bash
|
||||
python webui.py
|
||||
```
|
||||
|
||||
Se estiver usando Windows ou macOS, você pode baixar e extrair `RVC-beta.7z` para usar RVC diretamente usando `go-webui.bat` no Windows ou `sh ./run.sh` no macOS para iniciar o Webui.
|
||||
Servidor Ubuntu sem interface gráfica:
|
||||
|
||||
## Suporte ROCm para placas gráficas AMD (somente Linux)
|
||||
Para usar o ROCm no Linux, instale todos os drivers necessários conforme descrito [aqui](https://rocm.docs.amd.com/en/latest/deploy/linux/os-native/install.html).
|
||||
|
||||
No Arch use pacman para instalar o driver:
|
||||
````
|
||||
pacman -S rocm-hip-sdk rocm-opencl-sdk
|
||||
````
|
||||
|
||||
Talvez você também precise definir estas variáveis de ambiente (por exemplo, em um RX6700XT):
|
||||
````
|
||||
export ROCM_PATH=/opt/rocm
|
||||
export HSA_OVERRIDE_GFX_VERSION=10.3.0
|
||||
````
|
||||
Verifique também se seu usuário faz parte do grupo `render` e `video`:
|
||||
````
|
||||
sudo usermod -aG render $USERNAME
|
||||
sudo usermod -aG video $USERNAME
|
||||
````
|
||||
Depois disso, você pode executar o WebUI:
|
||||
```bash
|
||||
python webui.py
|
||||
python webui.py --noautoopen
|
||||
```
|
||||
|
||||
A porta padrão é `7865`. Coloque modelos `.pth` em `assets/weights/` e arquivos `.index` em `assets/indices/`.
|
||||
|
||||
## Credits
|
||||
+ [ContentVec](https://github.com/auspicious3000/contentvec/)
|
||||
+ [VITS](https://github.com/jaywalnut310/vits)
|
||||
@@ -174,7 +217,7 @@ python webui.py
|
||||
+ [audio-slicer](https://github.com/openvpi/audio-slicer)
|
||||
+ [Vocal pitch extraction:RMVPE](https://github.com/Dream-High/RMVPE)
|
||||
+ The pretrained model is trained and tested by [yxlllc](https://github.com/yxlllc/RMVPE) and [RVC-Boss](https://github.com/RVC-Boss).
|
||||
|
||||
|
||||
## Thanks to all contributors for their efforts
|
||||
<a href="https://github.com/RVC-Project/Retrieval-based-Voice-Conversion-WebUI/graphs/contributors" target="_blank">
|
||||
<img src="https://contrib.rocks/image?repo=RVC-Project/Retrieval-based-Voice-Conversion-WebUI" />
|
||||
|
||||
Reference in New Issue
Block a user