ha-addons/wyoming-chatterbox/README.md

33 lines
890 B
Markdown
Raw Permalink Normal View History

2025-12-15 17:13:07 +00:00
# wyoming-chatterbox addon
wyoming protocol server for chatterbox tts with voice cloning. clone any voice with a 10-30 second sample.
## requirements
- nvidia gpu with 4gb+ vram
- gpu passthrough configured in your HA host
## configuration
| option | default | description |
|--------|---------|-------------|
| `voice_ref` | required | path to voice reference wav (place in /share/) |
| `volume_boost` | 3.0 | output volume multiplier |
| `device` | cuda | torch device (cuda or cpu) |
| `debug` | false | enable debug logging |
## setup
1. place your voice reference wav in `/share/voice_reference.wav`
2. configure the addon with the path
3. start the addon
4. add wyoming integration in HA pointing to port 10201
## voice reference tips
for best results:
- 10-30 seconds of clean speech
- no background music or noise
- consistent speaking style
- wav format (any sample rate)