ambient-faster-whisper-stt

name	ambient-faster-whisper-stt
description	Local faster-whisper STT provider for Ambient speech input validation.

Use this package only through Ambient's STT provider path. It implements:

faster_whisper_transcribe --audio <wav> --language <language> --output-json <path>

Operational notes:

• The default path is intentionally small: faster-whisper==1.1.1, tiny.en, CPU, int8, beam size 1.
• This package is adapter-only. It bundles Ambient descriptor metadata, these instructions, the Node wrapper, the Python runner, and tests; it does not bundle uv, Python, faster-whisper wheels, CTranslate2 binaries, or model weights.
• requests is installed explicitly in the uv environment because the live macOS smoke found the direct faster-whisper import path needed it.
• First real transcription may populate local uv/Python/faster-whisper/model caches. Treat health output as runtime-readiness guidance, not proof that all model assets are already downloaded.
• When validating first-run behavior, use pnpm run stt:faster-whisper-clean-cache from the repo root so uv, Python, Hugging Face, and XDG caches are isolated in the validation artifact.
• This is setup/control evidence for the Ambient STT product path. Do not present tiny.en as multilingual quality evidence.
• Use a larger model only after setting AMBIENT_FASTER_WHISPER_MODEL intentionally and recording the runtime/quality tradeoff.