Agent skill · software engineering · jeremylongshore
deepgram-core-workflow-b
Implement real-time streaming transcription with Deepgram WebSocket.
Why this skill is useful
Adds executable scripts for real-time streaming transcription using Deepgram's WebSocket API, which are not commonly found in public documentation.
What it needs
Requires @deepgram/sdk, sox installed locally. Requires deepgram account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Deepgram Core Workflow B: Live Streaming Transcription Examples Open a development streaming session with a non-sensitive test utterance, verify connection/authentication, partial/final transcript state, timeout, and close behavior. Enforce the session's data/consent policy and log a correlation ID plus state transitions—not audio bytes, API keys, or full participant speech. Overview Real-time streaming transcription using Deepgram's WebSocket API. The SDK manages the WebSocket connection via listen.live(). Covers microphone capture, interim/final result handling, speaker diarization, UtteranceEnd detection, auto-reconnect, and building an SSE endpoint for browser clients. Prerequisites @deepgram/sdk installed, DEEPGRAMAPIKEY configured Audio source: microphone (via Sox/rec), file stream, or WebSocket audio from browser For mic capture: sox installed (apt install sox / brew install sox) Instructions Step 1: Basic Live Transcription Step 2: Microphone Capture with Sox Step 3: Live Diarization Step 4: Auto-Reconnect with Backoff Step 5: SSE Endpoint for Browser Clients Step 6: KeepAlive for Long Sessions Output Live WebSocket transcription with interim/final results Microphone capture pipeline (Sox -> Deepgram) Speaker diarization in streaming mode Auto-reconnect with exponential backoff and jitter SSE endpoint for browser integration KeepAlive handling for long sessions Error Handling Issue Cause Solution ------- ------- ---------- WebSocket closes immediately Invalid API key or bad encoding params Check key, verify encoding/samplerate match audio No transcripts received Audio not being sent or wrong format Verify connection.send(chunk) is called with raw PCM High latency Network congestion Use interimresults: true for perceived speed rec command not found Sox not installed apt install sox or brew install sox Connection drops after 10s No audio + no KeepAlive Send connection.keepAlive() every 8s Garbled output Sample rate mismatch Ensure audio sample rate matches sam …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/deepgram-core-workflow-b