| name | mistral-stt |
| description | Transcribe audio files using Mistral AI Voxtral. |
| metadata | {"version":"1.0.18"} |
Mistral STT Skill
Standalone direct Node.js client for Mistral's Voxtral transcription API. The canonical client is scripts/transcribe.mjs; scripts/transcribe.sh is the shell entrypoint wrapper. There are no curl fallbacks or Python parser dependencies.
Usage
MISTRAL_API_KEY=xxx ./scripts/transcribe.sh audio.ogg [language] [model]
MISTRAL_API_KEY=xxx ./scripts/transcribe.sh --file audio.ogg --lang ru --model voxtral-mini-latest
language — optional; omitted means provider auto-detection.
model — optional; default: voxtral-mini-latest.
- Outputs only the transcription text.
- Fails fast when the file or
MISTRAL_API_KEY is missing.
- Supports both positional and flag-style invocation.
CLI Options
--file, -f — audio file path.
--lang, --language, -l — optional language code.
--model, -m — Mistral transcription model.
--help, -h — usage.
Dependencies
- Node.js 18+ with built-in
fetch, FormData, and Blob.
- Internet access.
Notes
- Default model:
voxtral-mini-latest.
- Parses Mistral JSON response and prints only the
text field.
- Preserves positional invocation used by
transcribe_mistral: transcribe.sh {file} {lang} {model}.