pediatric-ai-scribe-v3/docs/transcription-options.md

1.5 KiB

Transcription Options

Ped-AI currently supports server-side transcription through LiteLLM plus an explicit browser Web Speech preview option. Browser Whisper was removed and should not be offered in settings, documentation, public workers, or model download scripts.

Route STT through LiteLLM and configure the compliant upstream in LiteLLM.

Need Recommended provider
Server STT LiteLLM with a compliant upstream.
Real-time draft preview Browser Web Speech only with explicit user opt-in and privacy warning.

Auto-detect uses LiteLLM when LITELLM_API_BASE is configured. Direct Google, AWS, local Whisper, and OpenAI Whisper branches are not part of the app runtime.

Configuration

TRANSCRIBE_PROVIDER=litellm
LITELLM_API_BASE=https://your-litellm.example/v1
LITELLM_API_KEY=<key>
LITELLM_STT_MODEL=local-parakeet-v3

Failure Handling

  • Server transcription failures can create encrypted audio backups for retry.
  • Users can retry or delete failed backups from Settings.
  • Web Speech interim text is not a substitute for a server transcription response.

Removed Paths

These should remain absent unless the project intentionally reintroduces browser-local STT with a new design review:

  • public/js/browserWhisper.js
  • public/js/whisperWorker.js
  • public/js/whisperWorkerV2.js
  • public/models/Xenova/*
  • Browser Whisper setup/troubleshooting docs
  • Whisper model download scripts for public browser models