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 reference
examples — third-party platform integrations (Twilio, LiveKit, LangChain, etc.)
starters — runnable starter apps (framework × feature matrix)
docs — documentation finder
setup-mcp — Deepgram MCP server installation
1---
2name: recipes
3description: >
4 Find focused, runnable Deepgram recipes for a specific feature × language. Use whenever
5 someone wants a minimal working code snippet for ONE feature (transcribe URL, diarize,
6 smart-format, voice agent connect, etc.) rather than a full starter app. Recipes are
7 under 50 lines, read DEEPGRAM_API_KEY from env, and ship with a runnable example_test.
8 Covers Python, JavaScript, Go, .NET, Java, Rust, and the Deepgram CLI.
9metadata:
10 source: https://skillmd.com/skills/deepgram/recipes
11---
12
13# Deepgram Recipes
14
15Agent-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.
16
17## When to use recipes
18
19- You know the product and feature; you want the shortest working code
20- You want `example.py` / `example.js` / `example.go` / etc. you can copy into your project
21- You want a language-specific answer to "how do I call `{feature}` with the Deepgram SDK?"
22
23**Use a different skill when:**
24- You want a full starter app with a web UI, deploy config, etc. → `starters` skill
25- You want integration with a third-party platform (Twilio, LiveKit, Vercel AI SDK, Discord, etc.) → `examples` skill
26- You want the full API contract (params, responses, message shapes) → `api` skill
27
28## Browse recipes
29
30Repository: <https://github.com/deepgram/recipes>
31
32Coverage matrix: <https://github.com/deepgram/recipes/blob/main/COVERAGE.md>
33
34## Recipe structure
35
36```
37recipes/{language}/{product}/{version}/{recipe}/
38 example.{ext} # runnable, < 50 lines, reads DEEPGRAM_API_KEY from env
39 example_test.{ext} # runs the example as a subprocess, asserts output
40 README.md # feature explanation, params, sample output, how to run
41```
42
43## Products covered
44
45| Product | Recipe examples |
46|---|---|
47| 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 |
48| Speech-to-Text — Flux STT (`/v2/listen`) | streaming conversational transcription, EOT / eager-EOT, mid-session `Configure`, keyterms |
49| Text-to-Speech — Aura (`/v1/speak`) | generate-audio, stream-audio, websocket-streaming, select-model, select-encoding, bit-rate |
50| Audio Intelligence | summarize, sentiment, topics, intents, entities |
51| Voice Agents | connect, custom-llm, custom-tts, function-calling |
52
53Nova 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.
54
55**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.
56
57## Languages
58
59Python, JavaScript, Go, .NET, Java, Rust, plus the Deepgram CLI (`dg` / `deepctl`).
60
61## Install the related SDK skills
62
63For language-idiomatic patterns beyond a single recipe (full quick-starts, common patterns, gotchas), install the SDK-specific skills:
64
65```bash
66npx skills add deepgram/deepgram-python-sdk # Python
67npx skills add deepgram/deepgram-js-sdk # JavaScript / TypeScript
68npx skills add deepgram/deepgram-java-sdk # Java
69npx skills add deepgram/deepgram-go-sdk # Go
70npx skills add deepgram/deepgram-rust-sdk # Rust
71npx skills add deepgram/deepgram-dotnet-sdk # C# / .NET
72npx skills add deepgram/deepgram-swift-sdk # Swift
73npx skills add deepgram/deepgram-kotlin-sdk # Kotlin
74npx skills add deepgram/deepgram-browser-sdk # Browser TypeScript
75```
76
77## Related Deepgram skills
78
79- `api` — consolidated REST + WebSocket API reference
80- `examples` — third-party platform integrations (Twilio, LiveKit, LangChain, etc.)
81- `starters` — runnable starter apps (framework × feature matrix)
82- `docs` — documentation finder
83- `setup-mcp` — Deepgram MCP server installation