readiness-check

Readiness Check

Verify that all OpenCode plugin services are healthy and operational.

Quick Health Check

Run these commands to verify all services:

# 1. Check Whisper STT server
curl -s http://localhost:8787/health

# 2. Check Coqui TTS server
echo '{"text":"test", "output":"/tmp/test.wav"}' | nc -U ~/.config/opencode/coqui/tts.sock

# 3. Check running processes
ps aux | grep -E "whisper_server|tts_server" | grep -v grep

# 4. Check Supabase RLS (requires .env with SUPABASE_ANON_KEY)
source .env && curl -s "https://slqxwymujuoipyiqscrl.supabase.co/rest/v1/telegram_replies?select=id&limit=1" \
  -H "apikey: $SUPABASE_ANON_KEY" -H "Authorization: Bearer $SUPABASE_ANON_KEY"

# 5. Check Supabase migrations are in sync
supabase migration list

Service Details

Whisper STT Server

Purpose: Transcribes voice messages from Telegram to text.

Location: whisper/whisper_server.py

Default Port: 8787

Start Command:

cd /path/to/opencode-reflection-plugin/whisper
python3 whisper_server.py --port 8787 &

Health Check:

curl -s http://localhost:8787/health

Expected Response:

{
  "status": "healthy",
  "model_loaded": true,
  "current_model": "base",
  "available_models": ["tiny", "tiny.en", "base", "base.en", "small", "small.en", "medium", "medium.en", "large-v2", "large-v3"]
}

Troubleshooting:

• If not running: Start with the command above
• If model loading fails: Check Python dependencies (pip install openai-whisper)
• For faster startup: Use --model tiny (lower quality but faster)

---

Coqui TTS Server

Purpose: Generates speech audio from text responses.

Location: ~/.config/opencode/coqui/tts_server.py

Socket Path: ~/.config/opencode/coqui/tts.sock

PID File: ~/.config/opencode/coqui/server.pid

Health Check:

# Check socket exists
ls -la ~/.config/opencode/coqui/tts.sock

# Check process is running
cat ~/.config/opencode/coqui/server.pid
ps aux | grep "$(cat ~/.config/opencode/coqui/server.pid)"

# Test TTS generation
echo '{"text":"Hello, this is a test.", "output":"/tmp/test_tts.wav"}' | nc -U ~/.config/opencode/coqui/tts.sock