transcribe

name	transcribe
description	Transcribe audio and video files using the configured speech-to-text provider
compatibility	Designed for Vellum personal assistants
metadata	{"emoji":"🎙️","vellum":{"display-name":"Transcribe","category":"voice","activation-hints":["User has an audio or video file on disk they want converted to text","User wants speech-to-text on a recording, voice memo, podcast, or meeting capture","User asks for a transcript of a media file (mp3, wav, m4a, mp4, mov, etc.)"]}}

Transcribe audio and video files using the configured speech-to-text provider. Supports multiple STT providers including OpenAI Whisper, Deepgram, and Google Gemini — the active provider is selected in Settings under Speech-to-Text (services.stt).

Usage Notes

• The tool accepts a file_path (absolute path to a local audio or video file) to transcribe.
• Supported formats: any video (mp4, mov, etc.) or audio (mp3, wav, m4a, etc.) file.
• For video files, audio is automatically extracted via ffmpeg before transcription.
• Large files are automatically split into chunks for processing.
• If no STT provider credentials are configured, the tool will return an error with setup instructions.
• The STT provider (services.stt) is shared between transcription and telephony call paths.

Maintenance

When adding or modifying an STT provider, follow the onboarding checklist at assistant/docs/stt-provider-onboarding.md. That document covers the daemon catalog, config schema, adapter wiring, client catalog parity, and required tests.