Agent skill · software engineering · jeremylongshore
deepgram-sdk-patterns
Apply production-ready Deepgram SDK patterns for TypeScript and Python.
Why this skill is useful
Provides specific TypeScript and Python patterns for Deepgram SDK that enhance integration and refactoring practices.
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