Mainline RVC installieren

Mainline ist die Upstream-Retrieval-basierte Sprachkonvertierungs-WebUI. Nutzen Sie die Browseroberfläche für die Dateikonvertierung und Schulung. Verwenden Sie für die Mikrofonkonvertierung die separate Desktop-Oberfläche, die im Echtzeit-Guide] beschrieben ist.

Wählen Sie eine Installationsroute

Windows-Archiv

1. Öffnen Sie die Mainline Windows-Paket- und Asset-Downloads und wählen Sie das Archiv aus, das zu Ihrer GPU passt. Suchen Sie für die aktuelle Paketfamilie nach der Variante 20260718 NVIDIA, NVIDIA 50-Serie oder AMD/Intel. Wenn Sie bereits über eine ältere Version verfügen, die funktioniert, belassen Sie diese in einem eigenen Verzeichnis.
2. Extrahieren Sie das gesamte Archiv in einen beschreibbaren lokalen Ordner wie C:\RVC\Mainline. Lassen Sie Platz für den Download und die extrahierten Dateien. Öffnen Sie im Datei-Explorer den resultierenden Ordner und suchen Sie nach dem Launcher assets und der Python-Laufzeitumgebung. Wenn Sie ein weiteres umschließendes Verzeichnis sehen, öffnen Sie es.
3. Führen Sie go-webui.bat aus, falls vorhanden. Ältere Archive nennen es möglicherweise go-web.bat. Lassen Sie das Befehlsfenster geöffnet und warten Sie auf die lokale Adresse. Wenn der Browser nicht startet, öffnen Sie die im Terminal angezeigte Adresse. Ein üblicher Standardwert ist http://127.0.0.1:7865.
4. Bestätigen Sie, dass die Seite geöffnet wird und das Terminal weiterhin ausgeführt wird. Behalten Sie das Archiv bei, bis die erste Konvertierung erfolgreich ist.

Aktueller Quellzweig

Laden Sie die Mainline-Quell-ZIP] herunter und extrahieren Sie sie. Öffnen Sie ein Terminal im Verzeichnis, das webui.py und die Anforderungsdateien enthält. Die folgende Quellkonfiguration gilt für den Python 3.12-Zweig. Führen Sie jedes Snippet aus diesem Verzeichnis mit einem 64-Bit-Python 3.12-Interpreter aus.

Windows PowerShell

py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip setuptools wheel

Wenn PowerShell das Aktivierungsskript blockiert, öffnen Sie die Eingabeaufforderung im selben Verzeichnis und führen Sie .venv\Scripts\activate.bat aus. Unter Windows fügen Sie ffmpeg.exe und ffprobe.exe neben webui.py ein.

Ubuntu 24.04

sudo apt update
sudo apt install python3.12-venv python3.12-dev ffmpeg unzip libsndfile1 libportaudio2
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip setuptools wheel

Wählen Sie einen Abhängigkeitssatz. Die Dateinamen enthalten requirments, wie im Repository geschrieben. Führen Sie den passenden Block von oben nach unten aus.

CPU, AMD oder Intel

python -m pip install -r requirments_cpu_py312.txt

NVIDIA RTX 50-Serie

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

Unterstützte ältere NVIDIA-Karten

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

Überprüfen Sie, welchen Interpreter und Torch-Build das Terminal verwendet:

python -c "import sys, torch; print(sys.executable); print(torch.__version__); print(torch.cuda.is_available())"

Erwarten Sie, dass der Interpreterpfad .venv enthält. Die CUDA-Verfügbarkeit sollte True betragen, damit die NVIDIA CUDA-Inferenz funktioniert. CPU- und DirectML-Installationen können in dieser CUDA-Prüfung False anzeigen.

Installieren Sie die Shared-Feature- und Pitch-Modelle vor Ihrer ersten Konvertierung:

python -m pip install huggingface_hub
hf download lj1995/VoiceConversionWebUI --include "hubert_base/*" --local-dir assets
hf download lj1995/VoiceConversionWebUI rmvpe.pt --local-dir assets/rmvpe

Generische HuBERT-Checkpoints sind als Standardencoder für Stimmkonvertierung nicht empfohlen. Sie wurden für Sprachrepräsentationen trainiert und können Merkmale der Klangfarbe der Ausgangsstimme in die Ausgabe übertragen. Verwende den Encoder, den das RVC-Modell erwartet, etwa ContentVec, wenn das Modell damit trainiert wurde.

Windows DirectML-Setups, die das ONNX-Pitch-Modell verwenden, benötigen auch hf download lj1995/VoiceConversionWebUI rmvpe.onnx --local-dir assets/rmvpe. Der Schulungsleitfaden listet die zusätzlichen Schulungsressourcen auf.

Führen Sie python webui.py aus demselben Verzeichnis aus. Der Feature-Encoder sollte ein Ordner mit dem Namen assets/hubert_base sein, der die Konfiguration, die Vorverarbeitungskonfiguration und die Gewichtsdatei enthält. Wenn Sie ein älteres Archiv installiert haben, behalten Sie dessen gebündelte Dateien und Namenskonventionen bei.

Wenn sich die WebUI nicht öffnet

Wenn sich die Benutzeroberfläche öffnet, fahren Sie mit Ihrer ersten Dateikonvertierung fort.