vox-tts
Installation
SKILL.md
vox-tts
A self-hosted TTS service at https://vox.delo.sh wrapping VoxCPM2 with a postgres-backed voice profile store and support for multiple engines. Deployed at ~/docker/stacks/utils/vox/.
Quick reference
| Action | How |
|---|---|
| One-off synthesis (inline WAV bytes) | POST /synthesize { text, voice?, cfg?, steps? } → audio/wav |
| Synthesis for delivery to Telegram / browser / HA / Discord | POST /synthesize-url → {audio_url, engine, duration_s, bytes} |
| MCP tool: inline bytes (base64 WAV) | speak(text, voice?) |
| MCP tool: delivery URL (OGG/Opus, Telegram-ready) | speak_url(text, voice?) |
| MCP tool: list voices | list_voices_tool() |
| List voices (HTTP) | GET /voices |
| Add a voice | POST /voices (multipart: name, display_name, audio) |
| Interactive voice cloning (user says "clone my voice as…") | See Interactive voice cloning workflow below |
| Register with agent (Hermes/OpenClaw/Claude Code) | MCP server at https://vox.delo.sh/mcp/ (trailing slash required) |
| Node-RED | node-red-contrib-vox at ~/docker/stacks/utils/vox/node-red-contrib-vox/ |
| Health + engine status | GET /healthz |