Troubleshooting › Fix: Whisper Not Working in OpenCode Interrupt
Symptom: Type /ptt, record audio, but get "❌ Install whisper" error or transcription returns nothing.
⚠ 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.
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 →