Dot RVC Bridge

Give Dot a different voice with your own RVC model, locally on Windows.

English · 简体中文 · Download Windows Easy Edition

A desktop controller, installer, and optional MCP server for routing Dot's playback through a local RVC engine. Includes model import, playback selection, pitch control, original-voice bypass, and start/pause.

This independent community project converts audio played on your PC; it is not an official OpenAI plugin or a native Dot voice API. The supported installation path targets Windows x64 with an NVIDIA GPU; compatibility across GPU generations is not established.

Warning: existing virtual audio setups

Before installing or starting:

• Save/export your existing audio-software configuration and record Windows' default playback/recording devices, default communications devices, and per-app routes.

• This release specifically uses CABLE Input / CABLE Output (VB-Audio Virtual Cable). CABLE-A/B, Voicemeeter virtual devices, and other virtual cables are not interchangeable inputs in the current launcher. If another workflow already needs this cable, stop that workflow for the test; if both must run together, postpone using this release.

• Setup skips driver installation when it detects the expected CABLE Output device. Detection does not mean the cable is unused. If you already have VB-CABLE but setup still proposes installing it, cancel the driver installer and check the installed device/driver first. Do not uninstall or reinstall a working shared driver just to try this app.

• Start with headphones at low volume. Route only the app hosting Dot to CABLE Input, and keep RVC playback on physical headphones/speakers. Never feed RVC output back into the same cable or Dot's microphone. VB-CABLE forwards audio sent to its input to its output, so other apps using that input will also enter this route. VB-CABLE documentation.

If sound stops, echoes, or another app is affected:

1. Stop the RVC engine. In Windows Settings → System → Sound → Volume mixer, restore the Dot app's output to its previous device; use physical headphones/speakers temporarily to check normal playback. Check the app is unmuted. Microsoft's app-audio troubleshooting.

2. Restore your saved default devices, communications devices, and mixer/streaming-software routes. Restore Dot's usual microphone. Stop only the duplicate monitoring path introduced for this test, including Windows “Listen to this device” if you enabled it.

3. If a device is busy or unavailable, close the apps using it and reopen them after selecting the intended devices. After a VB-CABLE driver installation, reboot as the vendor instructs, then recheck defaults and device selections. VB-CABLE installation instructions.

4. Confirm your original audio workflow works before trying again. Avoid a global audio reset or driver removal as the first fix: other apps may rely on those settings or drivers. Closing this app does not automatically restore Windows routing or your other software's configuration.

Related MCP server: reaper-reapy-mcp

Quick start

1. Download dot-rvc-bridge-0.3.2-windows-easy.zip from Releases. Extract to a permanent, writable folder. Choose this asset, not GitHub's automatic “Source code” ZIP.

2. Double-click Setup.cmd. It installs private Python environments, CUDA-enabled PyTorch, the pinned engine, and base inference assets. The first install needs internet access, several GB of downloads, and about 15 GB of free disk space. No manual Python, Node.js, or C++ compiler installation is needed.

3. If VB-CABLE is missing, setup opens its signed installer. Accept the Windows administrator prompt for BUREL VINCENT, click Install Driver, and restart if requested. Keep your usual microphone and speakers as Windows defaults.

4. Double-click Start.cmd. Click Import .pth, select your model, choose playback headphones/speakers, then click Start.

5. In Windows Settings → System → Sound → Volume mixer, set the app hosting Dot to output to CABLE Input (VB-Audio Virtual Cable). Keep Dot's microphone set to your normal microphone. Start a conversation and listen.

If the app is absent from the mixer, play audio in it first. App-level routing can include its other sounds. The launcher does not change Windows defaults or per-app routing.

Dot app → CABLE Input → CABLE Output → RVC → headphones / speakers
Your microphone ─────────────────────────→ Dot

Restore normal sound: enable Original voice while the engine runs, or change the app's Windows output back to your headphones/speakers. Pausing or closing the engine silences audio still routed to the cable.

Support and limits

Find and download your own RVC character .pth on Hugging Face. This project does not choose, host, bundle, or automatically download character weights. No local character weights, indexes, converted model bundles, recordings, or personal settings are included. Models undergo structural and size checks; not every checkpoint is compatible. Raw bundles are limited to 100 MB. RVC v1, no-f0 models, training checkpoints, .index retrieval, CPU-only use, and other operating systems are outside this release's supported path. The desktop uses speaker 0 for multi-speaker models.

RVC changes timbre; source rhythm, expression, and pronunciation still matter. Use models and demo audio you have permission to use and share.

The easy ZIP

Includes the bilingual controller, public source, README.md, README_CN.md, agent.md / AGENTS.md, official uv 0.13.2, prebuilt fairseq 0.12.2 and ANTLR wheels, manifests, and license notices. Local development profiles and personal data are excluded. This is an online installer. Engine source, PyTorch, base assets, and VB-CABLE are downloaded during setup.

Runtime files stay in .venv/ and runtime/. Moving the folder after installation can break environment paths; install again in a new folder instead. There is no automatic updater.

Troubleshooting

The default buffer is 64 × 128 samples at 48 kHz: about 171 ms of input buffering, not measured total latency. See validation scope.

Optional MCP controls

Setup writes a machine-local mcp.json. Use its stdio entry with a compatible local MCP host after the desktop loads the engine. A cloud host's localhost is not your PC; direct Dot-to-MCP control has not been verified for this release.

Tools: get_voice_status, list_local_models, list_voice_models, select_voice_model, set_voice_pitch, set_voice_index_ratio, start_voice_audio, pause_voice_audio, and set_voice_bypass. Configure devices through the desktop or CLI first. The protected service has one active slot and keeps index ratio at zero.

Installing with an agent

Ask your agent to read AGENTS.md (also linked from agent.md). It covers installation, existing virtual-audio setups, verification and recovery. The agent can help you import your own weights, find candidates on Hugging Face when requested, or explain how to train an inference model using the official RVC project in a separate environment. Missing character weights do not prevent software-only setup; no character weights are bundled or selected automatically by the installer.

Development

uv run --no-project --python 3.13.5 scripts/bootstrap.py
.venv\Scripts\python.exe -m unittest discover -s tests -v
.venv\Scripts\python.exe scripts/package-source.py

Source installation fetches pinned wheels from this repository's release. Desktop, CLI, and MCP share Engine; adapters implement read_state() and write_setting(). Model import and the legacy CUDA engine use separate environments joined by a validated raw tensor format.

See architecture, extensions, model handling, and release builds.

Original bridge code is MIT licensed. Third-party components, model assets, and VB-CABLE retain their own terms. Thanks to w-okada/voice-changer, RVC, and the underlying model and library authors.