Upgrade Kokoro TTS

Upgrade MLX-Audio dependencies, re-download the model, and update bundled scripts.

Workflow

Step 1: Pre-upgrade health check

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --health
cat ~/.local/share/kokoro/version.json

Step 2: Execute upgrade

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --upgrade

This upgrades:

• Python packages: mlx-audio, soundfile, numpy
• Model weights: re-downloaded from mlx-community/Kokoro-82M-bf16
• Bundled scripts: kokoro_common.py and tts_generate.py re-copied from plugin
• version.json: rewritten with new versions

Step 3: Post-upgrade verification

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --health
cat ~/.local/share/kokoro/version.json

# Test synthesis
~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_generate.py \
  --text "Upgrade verification" --voice af_heart --lang en-us --speed 1.0 \
  --output /tmp/kokoro-upgrade-test.wav && echo "OK"

Rollback

If upgrade breaks TTS, do a clean reinstall:

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --uninstall
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --install

Model cache is preserved across uninstall, so reinstall reuses the cached model.

Troubleshooting

Issue	Cause	Solution
Upgrade fails	No internet or PyPI down	Check connectivity, retry
Import error after	mlx-audio incompatibility	Clean reinstall: --uninstall then --install
Model download slow	Large download	Wait for HuggingFace download to complete