AI/TLDR

Google Agent Development Kit (ADK)

A code-first Python framework for building, evaluating, and deploying AI agents

Overview

Agent Development Kit (ADK) is an open-source, code-first Python framework from Google for building, evaluating, and deploying AI agents. You define agents in Python and stay in control of how they behave, rather than wiring everything through a UI or config files.

It is aimed at developers who want to build single agents or coordinate several agents together. ADK 2.0 adds a graph-based Workflow Runtime for composing deterministic execution flows (routing, fan-out/fan-in, loops, retry, human-in-the-loop, and nested workflows) and a Task API for structured agent-to-agent delegation.

As a general agent framework, it gives you the building blocks to define agents, connect them into workflows, run them locally through a CLI or web UI, and move them toward deployment.

What it does

  • Code-first Python API for defining agents with a name, model, and instruction
  • Workflow Runtime: a graph-based engine for routing, fan-out/fan-in, loops, retry, state management, and nested workflows
  • Task API for structured agent-to-agent delegation, including multi-turn task mode and human-in-the-loop
  • Built-in local run tooling: interactive CLI (adk run) and a web UI (adk web)
  • Native support for multi-agent setups composed through Workflow edges
  • Optional integrations installable via the [extensions] extra

Getting started

Install the package with pip (Python 3.10+ is required), define an agent in Python, then run it locally with the ADK CLI or web UI.

Install ADK

Install the framework from PyPI. To add optional integrations, install the extensions extra instead.

bashbash
pip install google-adk

Define an agent

Create an agent with a name, a model, and an instruction. Expose it as root_agent so the CLI and web UI can find it.

pythonpython
from google.adk import Agent

root_agent = Agent(
    name="greeting_agent",
    model="gemini-2.5-flash",
    instruction="You are a helpful assistant. Greet the user warmly.",
)

Compose a workflow (optional)

Connect multiple agents with edges to run them in sequence using the Workflow Runtime.

pythonpython
from google.adk import Agent, Workflow

generate_fruit_agent = Agent(
    name="generate_fruit_agent",
    instruction="Return the name of a random fruit. Return only the name.",
)

generate_benefit_agent = Agent(
    name="generate_benefit_agent",
    instruction="Tell me a health benefit about the specified fruit.",
)

root_agent = Workflow(
    name="root_agent",
    edges=[("START", generate_fruit_agent, generate_benefit_agent)],
)

Run locally

Use the interactive CLI for a terminal session, or launch the web UI pointed at your agents directory.

bashbash
# Interactive CLI
adk run path/to/my_agent

# Web UI
adk web path/to/agents_dir

Commands and code are distilled from the project's own documentation — always check the official repo for the latest.

When to use it

  • Build a single LLM-backed agent in Python with a defined model and instruction
  • Coordinate several agents in a deterministic workflow with routing, loops, or fan-out/fan-in
  • Delegate subtasks between agents using the Task API, including human-in-the-loop steps
  • Prototype and test agents locally through the ADK CLI or web UI before deploying

How Google Agent Development Kit (ADK) compares

Google Agent Development Kit (ADK) alongside other open-source agent frameworks & builders tools AI/TLDR tracks, ranked by GitHub stars.

ToolStarsWhat it does
AutoGPT★ 185kOne of the earliest autonomous agent projects, now a platform for building and running agents from reusable blocks and workflows.
Agno★ 40.8kA fast Python framework (formerly Phidata) for building agents with memory, tools, and multimodal inputs, plus a runtime for deploying them in production.
AgentGPT★ 36.2kAgentGPT lets you name a custom AI, give it a goal, and watch it plan tasks, run them, and learn from the results, all from a web browser.
LangGraph★ 35.2kA library from the LangChain team for building stateful, graph-based agent workflows with explicit control over steps, memory, and human-in-the-loop checkpoints.
Composio★ 28.9kComposio is an open-source SDK for Python and TypeScript that gives AI agents ready-made tools to act on real apps and APIs across many agent frameworks.
Semantic Kernel★ 28.2kMicrosoft's SDK for adding agents, plugins, and planning to apps across .NET, Python, and Java.
smolagents★ 27.9kA minimal agent library from Hugging Face where the model writes and runs Python code to call tools and complete tasks.
Google Agent Development Kit (ADK)★ 20.2kA code-first Python framework for building, evaluating, and deploying AI agents