soniox-transcribe

Minimal Soniox speech-to-text CLI: config, doctor, transcribe


Keywords
soniox, stt, transcription, cli
License
MIT
Install
npm install soniox-transcribe@0.1.0

Documentation

soniox-transcribe

Minimal Soniox speech-to-text CLI. Configure a key, sanity-check auth, transcribe a local audio file to stdout or a path.

Install

npm install -g soniox-transcribe
# or: pnpm add -g soniox-transcribe

Requires Node 20+.

From source

pnpm install
pnpm run build
pnpm link --global

Usage

soniox-transcribe config                 # interactive: paste API key (hidden), Enter
soniox-transcribe doctor                 # verify key + API
soniox-transcribe path/to/audio.wav      # transcript → stdout
soniox-transcribe path/to/audio.wav -o /tmp/out.md

Config file: ~/.config/soniox-transcribe/config.json
Env overrides: SONIOX_API_KEY, SONIOX_BASE_URL, SONIOX_MODEL

Development

pnpm run type-check
pnpm test
pnpm run build

Pre-push hook (husky) runs type-check, test, and build.

License

MIT