recipes

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

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

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