deepgram-transcribe

Transcribes audio files or URLs with speaker diarization using the Deepgram API.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/CYRUS-pinto/pi-bot --skill deepgram-transcribe-cyrus-pinto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deepgram-transcribe
Source: https://github.com/CYRUS-pinto/pi-bot/tree/main/.agents/skills/deepgram-transcribe
Command: npx skills add https://github.com/CYRUS-pinto/pi-bot --skill deepgram-transcribe-cyrus-pinto

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests.

What problem does it solve? Converting audio recordings into readable transcripts with correctly attributed speakers is tedious manual work. This Skill automates transcription of audio files or URLs via the Deepgram API, identifies distinct speakers, and lets you assign real names to each speaker for a clean, readable transcript. ## Core Features & Use Cases - Audio Transcription with Diarization: Transcribes local audio files or remote URLs using Deepgram's nova-3 model with speaker separation and smart formatting. - Interactive Speaker Naming: Presents the first turns of each speaker so users can identify who's who, then maps speaker IDs to real names or descriptions. - Multilingual Support & Caching: Accepts a BCP-47 language tag (e.g., Spanish) and caches raw API responses so formatting never triggers a second paid API call. - Use Case: Transcribe a recorded podcast episode from a URL, identify the host and guest from their opening lines, and produce a clean transcript with each speaker's name attached. ## Quick Start Transcribe the audio file meeting-recording.mp3 with speaker names using the deepgram-transcribe skill.

Frequently Asked Questions about deepgram-transcribe

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I transcribe an audio file with speaker identification?

Run the transcribe command with your audio file path or URL, and the Deepgram API returns speaker-labeled turns using diarization. You then review the first utterances of each speaker, assign names, and run the format command to produce the final transcript.

How to transcribe a podcast or audio from a URL?

Pass the audio URL directly as the argument to the transcribe command instead of a local file path. The script sends the URL to the Deepgram API and caches the response locally, so formatting later requires no second API call.

Does Deepgram transcription support languages other than English?

Yes, pass a BCP-47 language tag with the --language flag, such as --language es for Spanish. If the output contains very few words, the audio language was likely misdetected and you should retry with the correct language tag.

Why does transcription fail with DEEPGRAM_API_KEY not set?

The script reads the API key from the DEEPGRAM_API_KEY environment variable and exits if it is missing. Export the key in your shell before running, for example with export DEEPGRAM_API_KEY="your_key".

What happens if I run format before transcribe?

The format command reads from a cached API response, so it fails with a 'No cached response found' error if transcribe was never run. Always run the transcribe command first to create the cache file.