# 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.

## Recommended Clinical Setup

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

```env
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
