recipes
Installation
SKILL.md
Deepgram Recipes
Agent-maintained micro-recipes showing how to use every Deepgram SDK feature across every supported language. Each recipe is a focused, runnable snippet — not a full app.
When to use recipes
- You know the product and feature; you want the shortest working code
- You want
example.py/example.js/example.go/ etc. you can copy into your project - You want a language-specific answer to "how do I call
{feature}with the Deepgram SDK?"
Use a different skill when:
- You want a full starter app with a web UI, deploy config, etc. →
startersskill - You want integration with a third-party platform (Twilio, LiveKit, Vercel AI SDK, Discord, etc.) →
examplesskill - You want the full API contract (params, responses, message shapes) →
apiskill
Browse recipes
Repository: https://github.com/deepgram/recipes
Coverage matrix: https://github.com/deepgram/recipes/blob/main/COVERAGE.md
Recipe structure
recipes/{language}/{product}/{version}/{recipe}/
example.{ext} # runnable, < 50 lines, reads DEEPGRAM_API_KEY from env
example_test.{ext} # runs the example as a subprocess, asserts output
README.md # feature explanation, params, sample output, how to run
Products covered
| Product | Recipe examples |
|---|---|
Speech-to-Text — Nova (/v1/listen) |
transcribe-url, transcribe-file, paragraphs, diarize, smart-format, utterances, summarize, sentiment, topics, intents, detect-entities, detect-language, redact, search, keywords, streaming |
Speech-to-Text — Flux (/v2/listen) |
streaming conversational transcription, EOT / eager-EOT, mid-session Configure, keyterms |
| Text-to-Speech | generate-audio, stream-audio, websocket-streaming, select-model, select-encoding |
| Audio Intelligence | summarize, sentiment, topics, intents, entities |
| Voice Agents | connect, custom-llm, custom-tts, function-calling |
Nova is the general-purpose STT family; Flux is designed for conversational audio and voice agents. Both are actively maintained — see the api skill's "Nova vs Flux" section for the decision guide.
Languages
Python, JavaScript, Go, .NET, Java, Rust, plus the Deepgram CLI (dg / deepctl).
Install the related SDK skills
For language-idiomatic patterns beyond a single recipe (full quick-starts, common patterns, gotchas), install the SDK-specific skills:
npx skills add deepgram/deepgram-python-sdk # Python
npx skills add deepgram/deepgram-js-sdk # JavaScript / TypeScript
npx skills add deepgram/deepgram-java-sdk # Java
npx skills add deepgram/deepgram-go-sdk # Go
npx skills add deepgram/deepgram-rust-sdk # Rust
npx skills add deepgram/deepgram-dotnet-sdk # C# / .NET
npx skills add deepgram/deepgram-swift-sdk # Swift
npx skills add deepgram/deepgram-kotlin-sdk # Kotlin
npx skills add deepgram/deepgram-browser-sdk # Browser TypeScript
Related Deepgram skills
api— consolidated REST + WebSocket API referenceexamples— third-party platform integrations (Twilio, LiveKit, LangChain, etc.)starters— runnable starter apps (framework × feature matrix)docs— documentation findersetup-mcp— Deepgram MCP server installation