π¦ ClawHub
Kokoro Agent Voices
by @nissan
Local zero-cost text-to-speech with per-agent voice profiles using Kokoro TTS (82M params). 54 voices available, named agent mappings, WAV output. Use when b...
TERMINAL
clawhub install kokoro-agent-voicesπ About This Skill
name: kokoro-agent-voices version: 1.0.1 description: Local zero-cost text-to-speech with per-agent voice profiles using Kokoro TTS (82M params). 54 voices available, named agent mappings, WAV output. Use when building voice-enabled agents without API costs. Requires espeak-ng and a Python environment with kokoro dependencies. metadata: {"openclaw": {"emoji": "π£οΈ", "requires": {"bins": ["python3", "espeak-ng", "espeak"], "env": []}, "primaryEnv": null, "network": {"outbound": true, "reason": "Downloads Kokoro model from Hugging Face Hub on first run (~350MB). All subsequent inference is local."}, "security_notes": "Outbound network is used only once to download the Kokoro model weights from Hugging Face Hub (~350MB, one-time). All subsequent TTS inference runs entirely on the user's device. No audio data or text is ever transmitted externally."}}
Kokoro Agent Voices
Give each AI agent a distinct voice using Kokoro TTS β a lightweight 82M parameter model that runs locally with zero API costs. 54 voices across American, British, and other accents.
Agent Voice Profiles
AGENT_VOICES = {
"loki": "am_fenrir", # Deep, authoritative
"archie": "bm_george", # British analytical
"sara": "af_bella", # Warm, creative
"kit": "am_echo", # Clear, technical
"liv": "af_nova", # Bright, energetic
"belle": "bf_emma", # Refined, thoughtful
}
Usage
python3 scripts/speak.py --agent loki "System check complete"
python3 scripts/speak.py --voice af_bella "Hello world" --output /tmp/greeting.wav
python3 scripts/speak.py --list-voices # Show all 54 voices
python3 scripts/speak.py --list-agents # Show configured agent profiles
Setup
Requires a Python environment with kokoro, soundfile, and espeak-ng installed. The model downloads automatically from Hugging Face on first use (~350MB).
Files
scripts/speak.py β TTS script with agent profiles and voice selectionπ‘ Examples
python3 scripts/speak.py --agent loki "System check complete"
python3 scripts/speak.py --voice af_bella "Hello world" --output /tmp/greeting.wav
python3 scripts/speak.py --list-voices # Show all 54 voices
python3 scripts/speak.py --list-agents # Show configured agent profiles
βοΈ Configuration
Requires a Python environment with kokoro, soundfile, and espeak-ng installed. The model downloads automatically from Hugging Face on first use (~350MB).