TroubleshootingFix: Whisper Not Working in OpenCode Interrupt

Fix: Whisper Not Working in OpenCode Interrupt

Symptom: Type /ptt, record audio, but get "❌ Install whisper" error or transcription returns nothing.

Common Causes

⚠ Whisper binary not installed

Run bash scripts/install-whisper.sh from the plugin directory. This clones, builds, and installs whisper.cpp to ~/.local/bin/.

⚠ Whisper not on PATH

Ensure ~/.local/bin/ is in your PATH. Add export PATH="$PATH:$HOME/.local/bin" to ~/.bashrc.

⚠ Model file missing

Download the model: curl -fSL https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.bin -o ~/.local/bin/ggml-base.bin

⚠ Wrong model path

Set the correct path: export WHISPER_MODEL=/path/to/ggml-model.bin. Or configure in opencode.json: { "whisperModel": "small" }.

⚠ Permission denied

Ensure the whisper binary is executable: chmod +x ~/.local/bin/whisper.

Fallback

Set OPENAI_API_KEY in your environment. The plugin will use OpenAI's Whisper API for transcription, which is more accurate and requires no local setup.

Still having trouble?

Contact support →