Loading...
Loading...
Diagnose Kokoro TTS issues. TRIGGERS - kokoro not working, tts diagnose, kokoro error, tts troubleshoot.
npx skill4agent add terrylica/cc-skills diagnose| Issue | Likely Cause | Diagnostic | Fix |
|---|---|---|---|
| Import error | Venv corrupted | | |
| Model not found | Download incomplete | | |
| Slow synthesis | First-run warmup | Time a test synthesis | Normal — subsequent runs use cached model |
| Not Apple Silicon | Intel/Linux system | | MLX-Audio requires Apple Silicon (M1+) |
| Wrong Python | Not 3.13 | | Rebuild venv with |
| Server won't start | Port in use | | Kill existing process or change port |
| No audio from CLI | Empty text | Check | Provide non-empty text |
# Platform check
echo "Arch: $(uname -m)"
echo "macOS: $(sw_vers -productVersion)"
# Venv check
[[ -d ~/.local/share/kokoro/.venv ]] && echo "Venv: OK" || echo "Venv: MISSING"
# Python version
~/.local/share/kokoro/.venv/bin/python --version 2>/dev/null || echo "Python: NOT FOUND"
# MLX-Audio import
~/.local/share/kokoro/.venv/bin/python -c "from mlx_audio.tts.utils import load_model; print('MLX-Audio: OK')" 2>&1 || echo "MLX-Audio: FAIL"
# Scripts present
for f in kokoro_common.py tts_generate.py tts_server.py; do
[[ -f ~/.local/share/kokoro/$f ]] && echo "$f: OK" || echo "$f: MISSING"
done
# Version info
cat ~/.local/share/kokoro/version.json 2>/dev/null || echo "version.json: MISSING"# Quick synthesis test
~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_generate.py \
--text "Diagnostic test" --voice af_heart --lang en-us --speed 1.0 \
--output /tmp/kokoro-diag-test.wav && echo "Synthesis: OK"