Local Vosk STT

Lightweight local speech-to-text using Vosk. Fully offline after model download.

Use Cases

• Telegram voice messages — transcribe .ogg voice notes automatically
• Audio files — any format ffmpeg supports
• Offline transcription — no API keys, no cloud, no costs

Quick Start

# Transcribe Telegram voice message
./skills/local-vosk/scripts/transcribe voice_message.ogg

# Transcribe any audio
./skills/local-vosk/scripts/transcribe audio.mp3

# With language (default: en-us)
./skills/local-vosk/scripts/transcribe audio.wav --lang en-us

Supported Formats

Any format ffmpeg can decode: ogg (Telegram), mp3, wav, m4a, webm, flac, etc.

Models

Default model: vosk-model-small-en-us-0.15 (~40MB)

Other models available at https://alphacephei.com/vosk/models

Setup (if not installed)

pip3 install vosk --user --break-system-packages

# Download model
mkdir -p ~/vosk-models && cd ~/vosk-models
wget https://alphacephei.com/vosk/models/vosk-model-small-en-us-0.15.zip
unzip vosk-model-small-en-us-0.15.zip

Notes

• Quality is good for conversational speech
• For higher accuracy, use larger models or faster-whisper
• Processes audio at ~10x realtime on typical hardware
• Telegram voice messages are .ogg format — works out of the box