Kokoro TTS Health Check
Run 6 health checks to verify the Kokoro TTS engine installation.
Checks
| # | Check | Command |
| --- | ---------------- | --------------------------------------------------------------- |
| 1 | Venv exists | [[ -d ~/.local/share/kokoro/.venv ]] |
| 2 | Python 3.13 | ~/.local/share/kokoro/.venv/bin/python --version \| grep 3.13 |
| 3 | mlx_audio import | python -c "from mlx_audio.tts.utils import load_model" |
| 4 | kokoro_common.py | [[ -f ~/.local/share/kokoro/kokoro_common.py ]] |
| 5 | tts_generate.py | [[ -f ~/.local/share/kokoro/tts_generate.py ]] |
| 6 | version.json | [[ -f ~/.local/share/kokoro/version.json ]] |
Execution
PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --health
Failure Recommendations
| Failure | Recommended Skill | | --------------- | ------------------ | | Venv missing | install | | Import fails | install or upgrade | | Scripts missing | install | | version.json | install |
Troubleshooting
| Issue | Cause | Solution |
| ----------------- | -------------- | ------------------------------------------------ |
| All checks fail | Not installed | Run /kokoro-tts:install first |
| Only import fails | Venv corrupted | kokoro-install.sh --uninstall then --install |