# RLD UVR-Opt: Ultimate Vocal Remover GUI (Optimized)
[](https://github.com/revlaydust/rld-uvr-opt/releases/latest)
[](#license--references)
[](https://www.python.org/downloads/latest/python3.11/)
[-informational.svg?logo=windows&logoColor=white)](#-installation--prerequisites)
[](#-installation--prerequisites)
**High-performance, memory-optimized distribution of Ultimate Vocal Remover GUI (UVR v5.6).**
Focused on accelerated **ONNX Runtime inference**, lower hardware VRAM usage, and faster CLI startup.
## Up to ~5.3x Faster Inference | ~76% Lower VRAM Usage
*~3.5x faster & ~52% lower VRAM on stable CUDA EP. Up to ~5.3x faster & ~76% lower VRAM with experimental TensorRT-RTX EP (see [Verified Benchmarks](#verified-benchmarks)).*
[Prerequisites & Installation](#installation--prerequisites) $\cdot$ [Usage & Quick Start](#usage--quick-start) $\cdot$ [Key Features](#key-features) $\cdot$ [Verified Benchmarks](#verified-benchmarks) $\cdot$ [Roadmap](#roadmap) $\cdot$ [Credits](#credits--acknowledgments)
---
## Installation & Prerequisites
### 1. System Requirements & Platform Support
> [!IMPORTANT]
> **Platform Support**: RLD UVR-Opt is actively tested and optimized exclusively for **Windows 10 / 11 (64-bit)**.
* **Compute Device**:
* **NVIDIA GPU (CUDA EP - Stable)**: NVIDIA GeForce RTX 20 Series (Turing) or higher with at least 6GB VRAM (**8GB+ VRAM recommended for optimal performance**).
* **NVIDIA GPU (TensorRT-RTX EP - Experimental)**: NVIDIA GeForce RTX 30 Series (Ampere) or higher (RTX 30, 40, 50 series, RTX Ada/Blackwell).
*(Note: Turing / RTX 20-series GPUs are not supported by the TensorRT-RTX execution provider; RTX 20 users should use the stable CUDA EP).*
* **CPU**: Multi-core modern 64-bit x86 processor (fully supported via multi-threaded CPU inference).
* *(Note: Hardware focus is strictly on **GPU** and **CPU**).*
* **Python**: **Optional** (the automated installer automatically bootstraps a standalone Python 3.11 environment via `uv`). Installing system **Python 3.11+ (64-bit)** is only required if you plan on manual setup, development, or debugging.
### 2. Model & Architecture Scope
> [!NOTE]
> **ONNX Model Priority**:
RLD UVR-Opt's core acceleration pipeline is built around ONNX Runtime for `.onnx` models.
**Officially supported and tested**: `.onnx` models from the **MDX-Net family** on the documented CUDA and CPU paths.
**Legacy/Experimental**: non-`.onnx` models may still load through existing UVR components, but they are currently untested and may not function as expected.
---
### 3. One-Click Automated Installation (Windows)
RLD UVR-Opt provides an automated installer that handles your entire environment setup from start to finish.
> [!TIP]
> π **[Download the installer from the Latest Release](https://github.com/revlaydust/rld-uvr-opt/releases/latest)**
> [](https://github.com/revlaydust/rld-uvr-opt/releases/latest)
#### Step 1: Download the Installer
1. Open the **[Latest Release](https://github.com/revlaydust/rld-uvr-opt/releases/latest)** page.
2. Scroll down to the **Assets** section (click it to expand if it is collapsed) and click the file whose name ends with `Installation.bat`, for example `v1.2.3_Installation.bat`. The numbers are just the version and change with every release. Do **not** click *Source code (zip)* or *Source code (tar.gz)*, because those are not the installer.
3. Save it in the folder where you want RLD UVR-Opt to be set up. The installer will create a new folder whose name starts with `RLD-UVR-Opt` right next to it and download the project there.
> [!NOTE]
> Your browser or Windows SmartScreen may warn you about a downloaded `.bat` file. The script is plain text, so you can open it in any text editor to review it before running.
#### Step 2: Run the Installer
Double-click the file you just downloaded (the one ending with `Installation.bat`) in File Explorer, then choose an installation mode from the menu:
* **`[1]` Advanced Installation (Recommended)** β best if you need more flexibility. It clones the repository with `git`, so **Git is required**. If Git is not installed, the installer offers to download and install it for you, either automatically or manually.
* **`[2]` Standard Installation** β best if you want something simple that just works. It downloads and extracts the release ZIP, with no Git required.
The installer then launches the project's setup script automatically and takes care of the rest.
#### Step 3: Run the GUI
> [!IMPORTANT]
> If you installed the **GPU version**, you must follow these steps:
1. Open UVR using `run_uvr.bat` or `python UVR.py`.
2. Go to **Main Settings** (to the left of the **Start Processing** button with the wrench icon) β **Additional Settings** β Change **GPU Device** from the default setting to your GPU using the dropdown menu.
3. Still in **Additional Settings**, choose an **Execution Provider** (directly below **GPU Device**):
* The **Execution Provider** dropdown stays locked (greyed out) until a **GPU Device** has been selected in step 2.
* Once unlocked, UVR lists only the providers that are actually available for your GPU:
* `CUDAExecutionProvider` β default and stable baseline for all supported NVIDIA GPUs (RTX 20 series / Turing and newer).
* `NvTensorRTRTXExecutionProvider` β experimental and faster. Requires **NVIDIA RTX 30 series (Ampere) or newer**. It is only listed if you chose the **TensorRT-RTX EP** option in the installer and your GPU meets the hardware requirement (Turing / RTX 20 series users should select `CUDAExecutionProvider`).
* If your installation only supports `CPUExecutionProvider`, both **GPU Device** and **Execution Provider** are hidden and disabled.
> [!IMPORTANT]
> **You MUST restart UVR every time you change the Execution Provider and GPU Conversions.** The provider is applied when UVR starts, so a change made while UVR is running does not take effect until you restart. Use the **Restart Application** button in the settings menu, or close and re-open UVR.
4. Go back to the main menu, then enable **GPU Conversions**.
5. Re-open UVR.
6. Done! You can now start using it!
If you installed the **CPU version**, simply launch UVR using `run_uvr.bat`, `python UVR.py`, or by double-clicking `run_uvr.bat` in File Explorer.
> If you encounter any specific issues, feel free to [open an issue](https://github.com/revlaydust/rld-uvr-opt/issues)!
#### What the One-Click Installer automates for you:
* **Guided Setup**: Pick **Advanced** (Git) or **Standard** (ZIP) mode from a simple menu. In Advanced mode, a missing Git is downloaded and installed for you on request.
* **Hardware & Driver Detection**: Automatically identifies your GPU architecture (NVIDIA RTX 20/30/40/50 series) and selects PyTorch CUDA 12.8 or optimized CPU fallback.
* **Python Environment Management**: Automatically bootstraps `uv` and provisions an isolated Python 3.11 virtual environment (`venv`).
* **Fast Dependency Installation**: Pulls and configures all required packages, including PyTorch and ONNX Runtime GPU/CPU.
* **Visual C++ Redistributable Auto-Install**: Checks whether Microsoft Visual C++ 2015β2022 Redistributable (x64) is installed. If missing or outdated, it automatically downloads and silently installs the official runtime to ensure native C-extensions and runtime DLLs load without errors.
* **Automated Media Binaries**: Detects existing system installations of **FFmpeg** and **rubberband-cli**. If either is missing, it automatically downloads and extracts portable binaries into the application folderβ**zero manual downloading required!**
* **Smoke Test Verification**: Runs an immediate runtime sanity check on tensor operations and ONNX execution providers before launching.