AGENT SKILL

ambient-faster-whisper-stt

Local faster-whisper STT provider for Ambient speech input validation.

License 许可
MIT
最近更新
2026-08-22
Stars
★ 0
Forks
0

01 前言 Front Matter

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

02 资源文件 4

03 SKILL.md 正文

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.

04 同仓库更多 Skills