Google ADK
Agent Development Kit (ADK) is an open-source, code-first Python framework for building, evaluating, and deploying AI agents. It provides a flexible and modular approach to orchestrate agent workflows, from simple tasks to complex multi-agent systems. It is designed for developers who want to apply software engineering principles to AI agent creation.
🎬 ADK 2 0 Web Features · Xiaomai Chen
✨ Key features
- Graph-based workflow runtime with routing, loops, and retry.
- Task API for structured agent-to-agent delegation.
- Modular multi-agent systems with flexible hierarchies.
- Rich tool ecosystem including OpenAPI and MCP.
- Code-first development in Python for testability.
- Agent Config for building agents without code.
🎯 Use cases
- Build a conversational agent with custom instructions and tools.
- Orchestrate multiple specialized agents in a workflow.
- Deploy agents to Cloud Run or Vertex AI Agent Engine.
- Evaluate agent performance with built-in evaluation commands.
- Create human-in-the-loop workflows with tool confirmation.
📦 Installation
🧰 Requirements: Python 3.10+; optional API keys for model providers like Gemini.
pip install google-adk
For transitive dependency protection, install with constraints file (example for Python 3.10):
curl -o constraints-3.10.txt https://raw.githubusercontent.com/google/adk-python/main/constraints-3.10.txt
pip install google-adk -c constraints-3.10.txt
rm constraints-3.10.txt
Optional integrations:
pip install "google-adk[extensions]"
Development version:
pip install git+https://github.com/google/adk-python.git@main
🚀 Usage
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.",
)
Run locally:
adk run path/to/my_agent
⚠️ Good to know
ADK 2.0 includes breaking changes from 1.x; sessions generated by ADK 2.0 are readable by ADK 1.28+ but incompatible with older 1.x versions.
❓ FAQ
What Python version is required?
Python 3.10 or higher is required.
Can I use ADK with models other than Gemini?
Yes, ADK is model-agnostic, though it is optimized for Gemini.
How do I run an agent locally?
Use the CLI command adk run path/to/my_agent for interactive CLI or adk web path/to/agents_dir for a web UI.
How do I install optional integrations?
Install with pip install "google-adk[extensions]".
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.