dsh-dania-voice
English | 简体中文
Local GPT-SoVITS text-to-speech for DeepSeek Harness. It reads assistant replies aloud in a
fine-tuned voice, controlled by a small draggable mascot hanging at the top of the interface.
Everything runs on your machine — no audio, no text leaves it.
How it works
DSH session events (assistant/message + turn/end)
│ take the final reply text, strip code blocks / tables / links
▼
Host: clean + merge into ≤120-char segments
│ POST http://127.0.0.1:9880/tts
▼
GPT-SoVITS api_v2.py (local, GPU)
│ wav → cache dir → queue
▼
Browser: poll /dania-voice/next → Web Audio playback
Playback happens in the browser on purpose: the Host process has no audio device, and the voice
should come out of the machine you are actually sitting at.
Requirements
| Item | Note |
|---|
| DSH | >= 0.1.7-rc.1 |
| Python | 3.10 – 3.12 (the installer looks for it; it does not install Python) |
| GPU | NVIDIA with 8 GB+ VRAM recommended. CPU works but is several times slower. |
| Disk | ~5 GB (PyTorch + base models + voice model) |
Install
dsh plugin --profile web add dsh-dania-voice
Then open the mascot panel and click One-click setup. The installer runs as a separate
process and reports progress into the same panel:
- creates a Python venv under the install directory
- installs PyTorch (CUDA build when
nvidia-smi is present)
- installs the inference dependencies
- downloads GPT-SoVITS source (~50 MB)
- downloads the pretrained base models (~1.6 GB)
- downloads the voice model and its reference audio (~320 MB)
It is idempotent — if it fails halfway, click again and completed steps are skipped. That matters
because step 5 is a 1.6 GB download.
The default install directory is $DSH_HOME/dania-voice. Override it with installDir if you
want it on another drive.
Usage
A mascot hangs at the top centre of the window:
- Click — toggle reading on/off
- Drag — move it anywhere; the position is remembered
- Right-click / Shift+click — open the settings panel
- While reading, the mascot gently bobs
Panel controls: volume, speed, temperature (lower = steadier, less breathiness), inter-sentence
pause, plus repeat last reply and say a line for testing.
Changing speed/temperature applies to the next synthesis; audio is cached by text + parameters,
so repeating with the same settings is instant.
Configuration
Written to $DSH_HOME/dania-voice/config.json by the panel. The config: block in your profile
patch works too and is overridden by the panel.
| Key | Default | Meaning |
|---|
enabled | true | Master switch |
volume / speed / temperature | 1 / 1 / 0.7 | Playback and sampling |
speakUser | false | Also read your own messages |
installDir | $DSH_HOME/dania-voice | Where the engine lives |
pythonPath / root / cacheDir | derived | Only needed for a hand-made install |
baseUrl | http://127.0.0.1:9880 | GPT-SoVITS endpoint |
autostart | true | Start the service when needed |
Troubleshooting
- Mascot shows a red border — the plugin's routes are not answering; check that the plugin is enabled.
- "Not installed yet" — click one-click setup, or check
$DSH_HOME/dania-voice/install.log.
- No sound but the panel says ready — the browser blocked autoplay; click the mascot once.
- Slow first line — the model takes 20–40 s to load into VRAM; later lines take 1–3 s.
Credits
- GPT-SoVITS by RVC-Boss — MIT.
- Dania voice model by villia on ModelScope.
The installer downloads it from the original repository; it is not redistributed here.
- Mascot artwork © 夜游人 (this project's author). Background art uses official promotional
material under the publisher's third-party usage policy.
This is a fan project. Wuthering Waves and its characters belong to Kuro Games.
