# Build a voice agent

> Deepgram workshops › Build a voice agent
> Web version: https://workshops.deepgram.com/voice-agent
> Run time: 2 hr 35 min core · up to 3 hr 5 min (estimate). Check it: `make check 00` (offline, no key).

Seven short missions take you from a first conversation to an agent with its own voice, timing, and tools. You run each one in the browser, then in your own code in Python, TypeScript, or Java. The code is in voice-agent-workshop.

You leave with a voice agent running in your own code, and you know which settings change how it hears, waits, thinks, and sounds.

## Missions

- [00 First words](https://workshops.deepgram.com/voice-agent/first-words.md): Get an agent talking back in a voice you picked. 20 min (estimate). Check: `make check 00`.
- [01 Let me finish](https://workshops.deepgram.com/voice-agent/let-me-finish.md): Read a phone number slowly and it waits. 25 min (estimate). Check: `make check 01`.
- [02 Read the room](https://workshops.deepgram.com/voice-agent/read-the-room.md): Push it past your frustration limit and it changes course. 25 min (estimate). Check: `make check 02`.
- [03 No dead air](https://workshops.deepgram.com/voice-agent/no-dead-air.md): Trigger a slow tool call and it talks through the wait. 30 min (estimate). Check: `make check 03`.
- [04 Polyglot](https://workshops.deepgram.com/voice-agent/polyglot.md): Switch languages mid-conversation and it follows. 25 min (estimate). Check: `make check 04`.
- [05 Mystery guest](https://workshops.deepgram.com/voice-agent/mystery-guest.md): Give your agent a secret identity and make someone guess it. 20 min (estimate). Check: `make check 05`.
- [06 Encore](https://workshops.deepgram.com/voice-agent/encore.md): Push speed and expressivity until it does an impression. 10 min (estimate). Check: `make check 06`.
- [Swap the brain](https://workshops.deepgram.com/voice-agent/swap-the-brain.md): Change the model that thinks, and hear what it costs. 15 min (estimate).
- [Second vertical](https://workshops.deepgram.com/voice-agent/second-vertical.md): Point the same agent at a different job, then adapt it to yours. 15 min (estimate).

## Set up and run it yourself

- A free Deepgram API key
- A laptop with a microphone, or a keyboard to type to the agent
- Get a free API key: https://console.deepgram.com/signup?jump=keys&utm_source=workshops&utm_medium=agent&utm_campaign=workshop-voice-agent&utm_content=md-voice-agent-get-key
- Pick your language: `make use py|ts|java`
- Check your setup offline, no key needed: `make check 00`
- Use this template: https://github.com/new?template_name=voice-agent-workshop&template_owner=deepgram-devs
- Open in Codespaces: https://codespaces.new/deepgram-devs/voice-agent-workshop?ref=0ea06755b25ef2d50a132186bed23bc60b04cbef
- AGENTS.md: https://github.com/deepgram-devs/voice-agent-workshop/blob/0ea06755b25ef2d50a132186bed23bc60b04cbef/AGENTS.md
- 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
