Mom-Portal/docs/WHISPER_VM.md

Faster-Whisper VM Setup

The sample env expects the Whisper service to run on the VM at 172.16.10.64:8000.

The backend expects a Whisper-compatible HTTP service:

WHISPER_VM_IP=172.16.10.64
WHISPER_VM_PORT=8000
WHISPER_API_URL=http://172.16.10.64:8000
WHISPER_TRANSCRIBE_PATH=/transcribe
WHISPER_HEALTH_PATH=/health
WHISPER_FILE_FIELD=file
WHISPER_ALLOW_MOCK=false

Expected endpoints:

• GET /health returns any 2xx status when the VM is ready.
• POST /transcribe accepts multipart audio and returns one of:

{
  "transcript_text": "Meeting transcript...",
  "language": "en",
  "duration": 123.45,
  "timestamps": [{ "start": 0, "end": 5, "text": "Hello" }]
}

The API retries failed requests, applies WHISPER_TIMEOUT_MS, and marks jobs as failed when the VM is unavailable.