Transcribe

Local audio transcription using faster-whisper in Docker.

Installation

cd /path/to/skills/transcribe/scripts
chmod +x install.sh
./install.sh

This builds the Docker image whisper:local and installs the transcribe CLI.

Usage

transcribe /path/to/audio.mp3 [language]

• Default language: es (Spanish)
• Use auto for auto-detection
• Outputs plain text to stdout

Examples

transcribe /tmp/voice.ogg          # Spanish (default)
transcribe /tmp/meeting.mp3 en     # English
transcribe /tmp/audio.m4a auto     # Auto-detect

Supported Formats

mp3, m4a, ogg, wav, webm, flac, aac

When Receiving Voice Messages

1. Save the audio attachment to a temp file
2. Run transcribe <path>
3. Include the transcription in your response
4. Clean up the temp file

Files

• scripts/transcribe - CLI wrapper (bash)
• scripts/install.sh - Installation script (includes Dockerfile inline)

Notes

• Model: small (fast) - edit install.sh for large-v3 (accurate)
• Fully local, no API key needed