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. →
starters skill
- You want integration with a third-party platform (Twilio, LiveKit, Vercel AI SDK, Discord, etc.) →
examples skill
- You want the full API contract (params, responses, message shapes) →
api skill
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 STT (/v2/listen) |
streaming conversational transcription, EOT / eager-EOT, mid-session Configure, keyterms |
Text-to-Speech — Aura (/v1/speak) |
generate-audio, stream-audio, websocket-streaming, select-model, select-encoding, bit-rate |
| Audio Intelligence |
summarize, sentiment, topics, intents, entities |
| Voice Agents |
connect, custom-llm, custom-tts, function-calling |
Nova is the general-purpose STT family; Flux STT is designed for conversational audio and voice agents. Both are actively maintained — see the api skill's "Nova vs Flux STT" section for the decision guide. Note that Flux STT (/v2/listen) and Flux TTS (/v2/speak) are separate products that share the Flux name.
Flux TTS (/v2/speak) has no recipes yet. The TTS recipes above cover Aura on /v1/speak only — there is no text-to-speech/v2 directory in the recipes repo. For Flux TTS, use the api skill's "Aura vs Flux TTS" section for the endpoint contract, or the starters skill's flux-tts apps (node, flask, fastapi, django, java) for runnable code.
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
1---2name: deepgram-recipes3description: Find focused, runnable Deepgram recipes for a specific feature × language. Use whenever someone wants a minimal working code snippet for ONE feature (transcribe URL, diarize, smart-format, voice agent connect, etc.) rather than a full starter app. Recipes are under 50 lines, read DEEPGRAM_API_KEY from env, and ship with a runnable example_test. Covers Python, JavaScript, Go, .NET, Java, Rust, and the Deepgram CLI.4---56# Deepgram Recipes78Agent-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.910## When to use recipes1112- You know the product and feature; you want the shortest working code13- You want `example.py` / `example.js` / `example.go` / etc. you can copy into your project14- You want a language-specific answer to "how do I call `{feature}` with the Deepgram SDK?"1516**Use a different skill when:**17- You want a full starter app with a web UI, deploy config, etc. → `starters` skill18- You want integration with a third-party platform (Twilio, LiveKit, Vercel AI SDK, Discord, etc.) → `examples` skill19- You want the full API contract (params, responses, message shapes) → `api` skill2021## Browse recipes2223Repository: <https://github.com/deepgram/recipes>2425Coverage matrix: <https://github.com/deepgram/recipes/blob/main/COVERAGE.md>2627## Recipe structure2829```30recipes/{language}/{product}/{version}/{recipe}/31 example.{ext} # runnable, < 50 lines, reads DEEPGRAM_API_KEY from env32 example_test.{ext} # runs the example as a subprocess, asserts output33 README.md # feature explanation, params, sample output, how to run34```3536## Products covered3738| Product | Recipe examples |39|---|---|40| 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 |41| Speech-to-Text — Flux STT (`/v2/listen`) | streaming conversational transcription, EOT / eager-EOT, mid-session `Configure`, keyterms |42| Text-to-Speech — Aura (`/v1/speak`) | generate-audio, stream-audio, websocket-streaming, select-model, select-encoding, bit-rate |43| Audio Intelligence | summarize, sentiment, topics, intents, entities |44| Voice Agents | connect, custom-llm, custom-tts, function-calling |4546Nova is the general-purpose STT family; Flux STT is designed for conversational audio and voice agents. Both are actively maintained — see the `api` skill's "Nova vs Flux STT" section for the decision guide. Note that Flux STT (`/v2/listen`) and Flux TTS (`/v2/speak`) are separate products that share the Flux name.4748**Flux TTS (`/v2/speak`) has no recipes yet.** The TTS recipes above cover Aura on `/v1/speak` only — there is no `text-to-speech/v2` directory in the recipes repo. For Flux TTS, use the `api` skill's "Aura vs Flux TTS" section for the endpoint contract, or the `starters` skill's `flux-tts` apps (node, flask, fastapi, django, java) for runnable code.4950## Languages5152Python, JavaScript, Go, .NET, Java, Rust, plus the Deepgram CLI (`dg` / `deepctl`).5354## Install the related SDK skills5556For language-idiomatic patterns beyond a single recipe (full quick-starts, common patterns, gotchas), install the SDK-specific skills:5758```bash59npx skills add deepgram/deepgram-python-sdk # Python60npx skills add deepgram/deepgram-js-sdk # JavaScript / TypeScript61npx skills add deepgram/deepgram-java-sdk # Java62npx skills add deepgram/deepgram-go-sdk # Go63npx skills add deepgram/deepgram-rust-sdk # Rust64npx skills add deepgram/deepgram-dotnet-sdk # C# / .NET65npx skills add deepgram/deepgram-swift-sdk # Swift66npx skills add deepgram/deepgram-kotlin-sdk # Kotlin67npx skills add deepgram/deepgram-browser-sdk # Browser TypeScript68```6970## Related Deepgram skills7172- `api` — consolidated REST + WebSocket API reference73- `examples` — third-party platform integrations (Twilio, LiveKit, LangChain, etc.)74- `starters` — runnable starter apps (framework × feature matrix)75- `docs` — documentation finder76- `setup-mcp` — Deepgram MCP server installation
delorenj