omarcevi.dev / workshops / coding-agent-workshop

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.

The agent loop: you send a request, the agent asks for tool calls, ADK runs your functions and sends back the results, until the model answers with text.
The whole idea in one picture. ADK runs the loop; you write the tools.

You build it in four steps, each a few lines on top of the last:

  1. An agent with no tools. A model and an instruction. It can talk about code, but it can't see yours.
  2. Give it hands. Three Python functions to list, read and write files.
  3. Close the loop. One more tool to run commands, so it can run the tests and check its own work.
  4. 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