deepgram-recipes

name

deepgram-recipes

description

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.

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