DevFest Kocaeli 2026 · Workshop guide · about 7 minutes to read
Build Your Coding Agent with Google ADK
The written version of the 60-minute hands-on workshop by Omar Elcircevi
Build a coding agent in about 100 lines of Python with Google's Agent Development Kit. It reads a project, edits files, runs the tests and keeps fixing until they pass.
A coding agent isn't magic. It's a model, a few tools and a loop. In this workshop you build one with Google's Agent Development Kit (ADK), one step at a time, until it can take a small Python project with failing tests and turn them green on its own.
You build it in four steps, each a few lines on top of the last:
- An agent with no tools. A model and an instruction. It can talk about code, but it can't see yours.
- Give it hands. Three Python functions to list, read and write files.
- Close the loop. One more tool to run commands, so it can run the tests and check its own work.
- Add guardrails. Keep it inside the project folder, and make it ask before it writes or runs anything.
Every step has a finished checkpoint in the repo, so you can't fall behind: copy the next one and keep going.
What you need: a Google Cloud project with billing (free trial credits work), and either a laptop with git and the gcloud CLI, or just a browser for Cloud Shell. Setup takes about 10 minutes.
The pages
- START · 1 MINSetupInstall uv, get a free Gemini API key, clone the repo and open the ADK dev UI.
- STEP 1 · 1 MINAn agent with no toolsA model plus an instruction: it can talk about code, but it can't see yours.
- STEP 2 · 1 MINGive it handsThree plain Python functions become tools to list, read and write files.
- STEP 3 · 1 MINClose the looprun_command lets it run the tests, read the failures and fix until they pass.
- STEP 4 · 1 MINAdd guardrailsKeep it in the project folder, and make it ask before it writes or runs anything.
- HELP · 1 MINIf you get stuckCatch up with a checkpoint, and fixes for the common problems.
- WRAP-UP · 1 MINGoing furtherWhat to build next: smaller edits, undo, MCP tools, a real sandbox and evals.