Agent skill · software engineering · jeremylongshore
deepgram-sdk-patterns
Apply production-ready Deepgram SDK patterns for TypeScript and Python.
Why this skill is useful
Adds production-ready TypeScript and Python SDK patterns for Deepgram, including singleton client and audio intelligence pipeline scripts.
What it needs
Requires @deepgram/sdk, deepgram-sdk 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 SDK Patterns Examples Wrap the SDK behind a client that receives a scoped secret reference, validates media metadata, applies timeout/retry limits, and emits only redacted request metrics. Unit-test the wrapper with a mocked response; use a development fixture for one integration test and verify that credentials, audio, and transcript content never enter logs. Overview Production patterns for @deepgram/sdk (TypeScript) and deepgram-sdk (Python). Covers singleton client, typed wrappers, text-to-speech with Aura, audio intelligence pipeline, error handling, and SDK v5 migration path. Prerequisites npm install @deepgram/sdk or pip install deepgram-sdk DEEPGRAMAPIKEY environment variable configured Instructions Step 1: Singleton Client (TypeScript) Step 2: Text-to-Speech with Aura Step 3: Audio Intelligence Pipeline Step 4: Python Production Patterns Step 5: Typed Response Helpers Step 6: SDK v5 Migration Notes Output Singleton client pattern with environment validation Text-to-speech (Aura-2) with stream-to-file Audio intelligence pipeline (summary, topics, sentiment, intents) Python production service class Typed response helpers v5 migration reference Error Handling Error Cause Solution ------- ------- ---------- 401 Unauthorized Invalid API key Check DEEPGRAMAPIKEY value 400 Unsupported format Bad audio codec Convert to WAV/MP3/FLAC speak.request is not a function SDK version mismatch Check import, v5 uses speak.v1.audio.generate Empty TTS response Empty text input Validate text is non-empty before calling summarize returns null Feature not enabled Pass summarize: 'v2' (string, not boolean) Resources JavaScript SDK Python SDK SDK Feature Matrix TTS Voices Audio Intelligence Next Steps Proceed to deepgram-data-handling for transcript storage and processing patterns.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/deepgram-sdk-patterns--044195