🦀 ClawHub
speaker-local
by @babysor
Text-to-speech using Kokoro local TTS. Use when the user wants to convert text to audio, read aloud, or generate speech.
TERMINAL
clawhub install sayit📖 About This Skill
name: speak description: Text-to-speech using Kokoro local TTS. Use when the user wants to convert text to audio, read aloud, or generate speech.
speak
Convert text to speech locally with Kokoro TTS.
Quick start
# Text string → audio file
kokoro-tts <(echo "Hello world") hello.wav --voice af_sarahText file → audio
kokoro-tts article.txt out.wav --voice af_heartChinese
kokoro-tts story.txt out.wav --voice zf_xiaoni --lang cmnEPUB / PDF → chapter audio files
kokoro-tts book.epub --split-output ./chapters/ --format mp3 --voice bf_emmaVoice blending (60-40 mix)
kokoro-tts input.txt out.wav --voice "af_sarah:60,am_adam:40"Adjust speed
kokoro-tts input.txt out.wav --voice am_adam --speed 1.2Stream playback (no file saved)
kokoro-tts input.txt --stream --voice af_nova
Install
uv tool install kokoro-tts
Model files (kokoro-v1.0.onnx, voices-v1.0.bin) must be in the working directory. Download once:
wget https://github.com/nazdridoy/kokoro-tts/releases/download/v1.0.0/kokoro-v1.0.onnx
wget https://github.com/nazdridoy/kokoro-tts/releases/download/v1.0.0/voices-v1.0.bin
Voices at a glance
| Region | Female | Male | |--------|--------|------| | 🇺🇸 en-us | af_alloy af_heart af_sarah af_nova ... | am_adam am_echo am_michael ... | | 🇬🇧 en-gb | bf_alice bf_emma bf_lily ... | bm_daniel bm_george ... | | 🇨🇳 cmn | zf_xiaoni zf_xiaoxiao zf_xiaoyi ... | zm_yunxi zm_yunyang ... | | 🇯🇵 ja | jf_alpha jf_nezumi ... | jm_kumo | | 🇫🇷 fr-fr | ff_siwis | — | | 🇮🇹 it | if_sara | im_nicola |
For full voice list, options, and input format details, see reference.md.
💡 Examples
# Text string → audio file
kokoro-tts <(echo "Hello world") hello.wav --voice af_sarahText file → audio
kokoro-tts article.txt out.wav --voice af_heartChinese
kokoro-tts story.txt out.wav --voice zf_xiaoni --lang cmnEPUB / PDF → chapter audio files
kokoro-tts book.epub --split-output ./chapters/ --format mp3 --voice bf_emmaVoice blending (60-40 mix)
kokoro-tts input.txt out.wav --voice "af_sarah:60,am_adam:40"Adjust speed
kokoro-tts input.txt out.wav --voice am_adam --speed 1.2Stream playback (no file saved)
kokoro-tts input.txt --stream --voice af_nova