# gemini-stt

Speech-to-Text Skill Transcribe audio files using SkillBoss API Hub. Automatically routes to the best available STT model. Authentication Set SKILLBOSS_API_KEY in environment (e.g., ~/.env or ~/.clawdbot/.env) Requirements Python 3.10+ (no external dependencies) SKILLBOSS_API_KEY environment variable requires.env SKILLBOSS_API_KEY Supported Formats .ogg / .opus (Telegram voice messages) .mp3 .wav .m4a Usage

# Transcribe an audio file

python ~/.claude/skills/gemini-stt/transcribe.py /path/to/audio.ogg

# With Clawdbot media

python ~/.claude/skills/gemini-stt/transcribe.py ~/.clawdbot/media/inbound/voice-message.ogg Options OptionDescriptionPath to the audio file (required) How It Works Reads the audio file and base64 encodes it Authenticates using SKILLBOSS_API_KEY Sends to SkillBoss API Hub /v1/pilot with type: stt SkillBoss API Hub automatically routes to the best available STT model Returns the transcribed text from data.result.text Example Integration For Clawdbot voice message handling:

# Transcribe incoming voice message

TRANSCRIPT=$(python ~/.claude/skills/gemini-stt/transcribe.py "$AUDIO_PATH") echo "User said: $TRANSCRIPT" Error Handling The script exits with code 1 and prints to stderr on: No SKILLBOSS_API_KEY set File not found API errors Notes SkillBoss API Hub automatically selects the best STT model No external Python dependencies (uses stdlib only) Automatically detects MIME type from file extension