- UVR.py: fix URL regex character range to prevent overly permissive matching - demucs/utils.py: bind free_port socket to localhost (127.0.0.1) using context manager - __version__.py: bump BUILD_ID to RLUV_20260923_2156 - README.md: fix Shields.io release badge URL and clean up heading emojis
RLD UVR-Opt: Ultimate Vocal Remover GUI (Optimized)
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 ~4x Faster Inference | ~53% Lower VRAM Usage
Prerequisites & Installation \cdot Usage & Quick Start \cdot Key Features \cdot Verified Benchmarks \cdot Roadmap \cdot Credits
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): NVIDIA GeForce RTX 20 Series GPU or higher with at least 6GB VRAM is the minimum requirement for GPU conversions (8GB+ VRAM recommended for optimal performance).
- CPU: Multi-core modern 64-bit x86 processor (fully supported via multi-threaded CPU inference).
- (Note: Hardware focus is strictly on CUDA 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.onnxmodels.
Officially supported and tested:.onnxmodels from the MDX-Net family on the documented CUDA and CPU paths. Legacy/Experimental: non-.onnxmodels 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 setup script that handles your entire environment setup from start to finish:
Step 1: Clone or Download the Repository
git clone https://github.com/revlaydust/rld-uvr-opt.git
cd rld-uvr-opt
(Or Download the ZIP and extract it to a folder).
Step 2: Run the Automated Installer
Simply double-click install\install_packages.bat in File Explorer, or run in terminal:
.\install\install_packages.bat
Step 3: Run the GUI
Important
If you installed the GPU version, you must follow these steps:
- Open UVR using
run_uvr.batorpython UVR.py. - 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.
- Go back to the main menu, then enable GPU Conversions.
- Re-open UVR.
- 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!
What the One-Click Installer automates for you:
- 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
uvand 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.
🛠️ Manual Installation via Astral uv (Click to Expand for Advanced Users)
If you prefer to configure your environment manually instead of running install\install_packages.bat, use Astral uv for lightning-fast setup:
-
Install Astral uv (if not already installed):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" -
Create Python 3.11 Virtual Environment via uv:
uv venv venv --python 3.11 .\venv\Scripts\activate -
Install PyTorch & ONNX Runtime with uv pip:
- For NVIDIA GPU (CUDA 12.8):
uv pip install torch==2.11.0 torchvision==0.26.0 torchaudio==2.11.0 --index-url https://download.pytorch.org/whl/cu128 - For CPU Only Fallback:
uv pip install torch==2.11.0 torchvision==0.26.0 torchaudio==2.11.0 --index-url https://download.pytorch.org/whl/cpu
- For NVIDIA GPU (CUDA 12.8):
-
Install Base Dependencies with uv pip:
- For NVIDIA GPU:
uv pip install -r .\install\requirements.txt - For CPU Only:
uv pip install -r .\install\requirements_cpu.txt
- For NVIDIA GPU:
-
Place External Media Binaries:
- Place
ffmpeg.exein the application root folder (or ensure it is in your systemPATH). - Place
rubberband.exeandsndfile.dllin the application root folder (or ensure it is in your systemPATH).
- Place
Usage / Quick Start
Get from zero to audio separation in seconds:
A. Launch the GUI
Simply run the included launcher batch file or start via Python:
.\run_uvr.bat
Or via terminal:
python UVR.py
B. UVR Command-Line Interface (UVR-CLI)
RLD UVR-Opt provides a dedicated, lightweight CLI designed for automation and headless environments:
# 1. View all available commands instantly
uvr_cli --help
# 2. Run high-performance separation with MDX-Net Inst_HQ_4
uvr_cli run --audio "path/to/song.wav" --model "UVR-MDX-NET-Inst_HQ_4.onnx" --output "output_stems"
# 3. High-throughput separation with custom overlap and segment size
uvr_cli run -a "song.wav" -m "UVR-MDX-NET-Inst_HQ_4.onnx" --overlap 0.50 --segment-size 4000 -o "output_stems"
Key Features
- Accelerated ONNX Inference: Optimized tensor pipelines and buffer handling reduce unnecessary overhead during chunk processing.
- In-Memory FP16 Conversion: FP16 conversion is performed in memory without requiring persistent
.fp16.onnxfiles. - Memory & Session Management: Improved session and allocation handling helps reduce unnecessary resource usage across runs.
- Faster CLI Startup: Deferred loading of heavy runtime modules reduces startup work before inference is requested.
- Benchmark Telemetry: Built-in measurements and metadata help compare inference performance across controlled test runs.
Verified Benchmarks
All metrics were gathered using the built-in isolated benchmark suite on identical test audio (48.34s stereo WAV, model: UVR-MDX-NET-Inst_HQ_4.onnx, Ultra Quality FP32). The results below reflect the documented test configuration and are not a universal performance guarantee.
Test Hardware: NVIDIA GeForce RTX 5060 Ti | AMD Ryzen 5 5600 6-Core Processor | 32 GB RAM | Windows 11
1. GPU Inference Performance (CUDA)
| Configuration | Metric | UVR v5.6 (Legacy) | RLD UVR-Opt | Improvement |
|---|---|---|---|---|
| Overlap 0.75 (Segment: 4000) |
Inference Time Processing Speed Peak Device VRAM PyTorch VRAM Alloc |
13.52 s 3.58x Realtime 8,210 MB 6,360 MB |
3.85 s 12.54x Realtime 3,941 MB 177.5 MB |
~3.5x Faster +250% Throughput -52.0% VRAM Usage (4.2 GB Saved) -97.2% PyTorch VRAM Allocation |
| Overlap 0.50 (Segment: 4000) |
Inference Time Processing Speed Peak Device VRAM |
7.99 s 6.05x Realtime 8,214 MB |
2.06 s 23.44x Realtime 3,893 MB |
~3.87x Faster +287% Throughput -52.6% VRAM Usage (4.3 GB Saved) |
2. CPU Inference Performance
| Configuration | Metric | UVR v5.6 (Legacy) | RLD UVR-Opt | Improvement |
|---|---|---|---|---|
| Overlap 0.50 (Segment: 4000) |
Inference Time Processing Speed Peak System RAM |
79.84 s 0.61x Realtime 8,928 MB |
32.17 s 1.50x Realtime 3,210 MB |
~2.48x Faster +146% Throughput -64.0% RAM Usage (5.7 GB Saved) |
Note
Raw per-round session logs and metric datasets are preserved in
benchmark_results/(summary.csvandsummary_legacy.csv).
Roadmap
- Accelerated ONNX inference pipeline and buffer optimizations.
- In-memory
FP16downcasting (e.g.,FP32\rightarrowFP16) and cache lifecycle management. - In-memory
BF16/FP8 E4M3FNdowncasting. - Windows ML (via ONNX Runtime): Evaluate as a broader Windows execution-provider path for supported hardware.
- TensorRT Execution Provider (via ONNX Runtime): Evaluate as an optional NVIDIA acceleration path, with CUDA EP retained as the stable fallback.
- Support for Newer Model Architectures.
- UI/UX Overhaul.
Credits & Acknowledgments
RLD UVR-Opt Maintainer
- RevLayDust — Core architecture optimizations, ONNX pipeline acceleration, CLI engine, and memory lifecycle management.
Core UVR Developers
Special Thanks & Upstream Contributors
- ZFTurbo — Created & trained weights for MDX23C models.
- DilanBoskan — Essential contributions at the start of the UVR project.
- Bas Curtiz — Designed the official UVR logo, icon, banner, and splash screen.
- tsurumeso — Developed the original VR Architecture code.
- Kuielab & Woosung Choi — Developed the original MDX-Net AI code.
- Adefossez & Demucs — Core developer of Facebook's Demucs Music Source Separation.
- KimberleyJSN — Advised and aided implementation of training scripts for MDX-Net and Demucs.
- Hv — Helped implement chunk processing into MDX-Net AI code.
- Audio Separation & CC Karaoke Discord Communities — For continuous testing, feedback, and support.
License & References
The Ultimate Vocal Remover GUI and RLD UVR-Opt codebase is open-source and released under the MIT License.
Copyright (c) 2022 Ultimate Vocal Remover
Copyright (c) 2026 RevLayDust
Academic References
- [1] Takahashi et al., "Multi-scale Multi-band DenseNets for Audio Source Separation", arXiv:1706.09588