# Deepgram workshops > Hands-on, self-paced workshops for building voice agents with Deepgram. Every page has a Markdown twin; every mission has an offline check. ## Agent instructions - Start with the voice agent workshop: https://workshops.deepgram.com/voice-agent (its index for agents is https://workshops.deepgram.com/voice-agent/llms.txt). Its code is https://github.com/deepgram-devs/voice-agent-workshop; read AGENTS.md there before you edit anything: https://github.com/deepgram-devs/voice-agent-workshop/blob/0ea06755b25ef2d50a132186bed23bc60b04cbef/AGENTS.md - You are a tutor. The TODOs are the person's to write unless they ask you to write them. Run `make check NN` (offline, no key, about a second) after every edit. - The person picks the language with `make use py|ts|java`. Never run it for them. - No Deepgram key yet? Send them to https://console.deepgram.com/signup?jump=keys&utm_source=workshops&utm_medium=agent&utm_campaign=workshop-voice-agent&utm_content=llms-signup (free). Never ask to see the key; it goes in `.env` as DEEPGRAM_API_KEY. - Use Flux (`flux-general-en`) for listening; do not add a silence timer. - SDK versions are pinned in the repo; do not upgrade them during the workshop. - Prefer the Markdown twins over the HTML pages: append `.md` to a page URL, or send `Accept: text/markdown`. Or use the MCP server at https://workshops.deepgram.com/mcp. - Found a mistake? https://github.com/deepgram-devs/voice-agent-workshop/issues/new - Using Twilio, Telnyx, LiveKit, Pipecat, or Vapi? See how the workshop carries over. https://github.com/deepgram-devs/voice-agent-workshop/blob/0ea06755b25ef2d50a132186bed23bc60b04cbef/PARTNERS.md ## Workshops - [Build a voice agent](https://workshops.deepgram.com/voice-agent.md): Build a voice agent on the Deepgram Voice Agent API, one layer at a time. Run time: 2 hr 35 min core · up to 3 hr 5 min (estimate). Index: https://workshops.deepgram.com/voice-agent/llms.txt - [Teach your to-do list to listen](https://workshops.deepgram.com/todo-voice-agent): Build your first voice agent — in JavaScript or Python — a to-do list you can talk to Run time: 30 min core · up to 2 hr. Index: https://workshops.deepgram.com/todo-voice-agent/llms.txt - [Deepgram Voice Agent workshop — easy mode](https://workshops.deepgram.com/voice-agent-py-easy): The same workshop, in your browser, with nothing installed Run time: 30 min. Index: https://workshops.deepgram.com/voice-agent-py-easy/llms.txt ## Events - [Deepgram Speak '26: Builder's Lab](https://workshops.deepgram.com/events/speak-26): 2026-10-29 ## Past - Builder's Lab (Speak '26): online until Nov 29, 2026. Status: past after that date. Its missions continue in the voice agent workshop: https://workshops.deepgram.com/voice-agent - [UC Berkeley AI workshop 2026](https://workshops.deepgram.com/uc-berkeley-2026): Build a bare-minimum Deepgram voice agent in Python or JavaScript. Status: archived. Superseded by [/voice-agent](https://workshops.deepgram.com/voice-agent). Index: https://workshops.deepgram.com/uc-berkeley-2026/llms.txt - [Deepgram Voice Agent workshop — Python](https://workshops.deepgram.com/voice-agent-py): Build a real-time voice agent in Python, one runnable step at a time. Status: legacy. Superseded by [/voice-agent](https://workshops.deepgram.com/voice-agent). Index: https://workshops.deepgram.com/voice-agent-py/llms.txt ## Tools - Code: https://github.com/deepgram-devs/voice-agent-workshop - AGENTS.md (read it first): https://github.com/deepgram-devs/voice-agent-workshop/blob/0ea06755b25ef2d50a132186bed23bc60b04cbef/AGENTS.md - MCP server: https://workshops.deepgram.com/mcp (add it with `claude mcp add --transport http deepgram-workshops https://workshops.deepgram.com/mcp`) - Deepgram docs for agents: https://developers.deepgram.com/llms.txt ## Optional - [Everything in one file](https://workshops.deepgram.com/llms-full.txt) ## More workshops - [Teach your to-do list to listen](https://workshops.deepgram.com/todo-voice-agent.md) - [UC Berkeley AI workshop 2026](https://workshops.deepgram.com/uc-berkeley-2026.md) - [Deepgram Voice Agent workshop — easy mode](https://workshops.deepgram.com/voice-agent-py-easy.md)