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: 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---5
6# Deepgram Recipes
7
8Agent-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.
9
10## When to use recipes
11
12- You know the product and feature; you want the shortest working code
13- You want `example.py` / `example.js` / `example.go` / etc. you can copy into your project
14- You want a language-specific answer to "how do I call `{feature}` with the Deepgram SDK?"
15
16**Use a different skill when:**
17- You want a full starter app with a web UI, deploy config, etc. → `starters` skill
18- You want integration with a third-party platform (Twilio, LiveKit, Vercel AI SDK, Discord, etc.) → `examples` skill
19- You want the full API contract (params, responses, message shapes) → `api` skill
20
21## Browse recipes
22
23Repository: <https://github.com/deepgram/recipes>
24
25Coverage matrix: <https://github.com/deepgram/recipes/blob/main/COVERAGE.md>
26
27## Recipe structure
28
29```
30recipes/{language}/{product}/{version}/{recipe}/
31 example.{ext} # runnable, < 50 lines, reads DEEPGRAM_API_KEY from env
32 example_test.{ext} # runs the example as a subprocess, asserts output
33 README.md # feature explanation, params, sample output, how to run
34```
35
36## Products covered
37
38| 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 |
45
46Nova 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.
47
48**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.
49
50## Languages
51
52Python, JavaScript, Go, .NET, Java, Rust, plus the Deepgram CLI (`dg` / `deepctl`).
53
54## Install the related SDK skills
55
56For language-idiomatic patterns beyond a single recipe (full quick-starts, common patterns, gotchas), install the SDK-specific skills:
57
58```bash
59npx skills add deepgram/deepgram-python-sdk # Python
60npx skills add deepgram/deepgram-js-sdk # JavaScript / TypeScript
61npx skills add deepgram/deepgram-java-sdk # Java
62npx skills add deepgram/deepgram-go-sdk # Go
63npx skills add deepgram/deepgram-rust-sdk # Rust
64npx skills add deepgram/deepgram-dotnet-sdk # C# / .NET
65npx skills add deepgram/deepgram-swift-sdk # Swift
66npx skills add deepgram/deepgram-kotlin-sdk # Kotlin
67npx skills add deepgram/deepgram-browser-sdk # Browser TypeScript
68```
69
70## Related Deepgram skills
71
72- `api` — consolidated REST + WebSocket API reference
73- `examples` — third-party platform integrations (Twilio, LiveKit, LangChain, etc.)
74- `starters` — runnable starter apps (framework × feature matrix)
75- `docs` — documentation finder
76- `setup-mcp` — Deepgram MCP server installation
deepgram