Build
Eight steps, from an empty folder to an agent running on a public URL. Nothing here assumes you attended the session.
| Step | What you do | Done when |
|---|---|---|
| 1 | Set up — uv, keys, accounts | /health returns ok: true |
| 2 | Create the database | Three tables in Supabase |
| 3 | Write the tools, expose them over MCP | You call them from the Inspector |
| 4 | The agent loop, by hand | It answers from your terminal |
| 5 | The same loop, with a framework | Same answer, a third of the code |
| 6 | Wire it up the wrong way | You get a timeout. On purpose. |
| 7 | Fix it: accept and poll | 202 in 200 ms, steps stream live |
| 8 | Deploy | A public URL you can send someone |
Before you start
Section titled “Before you start”You need four free accounts and about ten minutes. None of them ask for a card.
| Where | Why | |
|---|---|---|
| Google AI Studio key | https://aistudio.google.com/apikey | the model |
| Supabase project | https://supabase.com | Postgres + pgvector |
| Render account | https://render.com | hosting (step 8 only) |
| GitHub account | https://github.com | deploying from a repo |
Plus Python 3.11+ and a code editor.
How the steps work
Section titled “How the steps work”Each page has the same shape: what you’re doing, why, the code, the check that it worked, and what usually goes wrong. Steps 6 and 7 are a matched pair — 6 builds the bug deliberately so 7 has something to fix.
Your progress is remembered in this browser, so you can stop after any step and pick it up later.