---
title: "adk-python"
type: "tool"
slug: "google-adk-python"
canonical_url: "https://www.graphcanon.com/tools/google-adk-python"
github_url: "https://github.com/google/adk-python"
homepage_url: "https://google.github.io/adk-docs/"
stars: 20508
forks: 3658
primary_language: "Python"
license: "Apache-2.0"
categories: ["ai-agents"]
tags: ["agents-sdk", "multi-agents", "agentic", "agent"]
updated_at: "2026-07-07T18:26:48.394028+00:00"
---

# adk-python

> A Python-based toolkit for creating and deploying flexible AI agents with advanced capabilities.

ADK (Agent Development Kit) is an open-source framework for building, evaluating, and integrating sophisticated AI agents in Python. It supports workflows and multi-agent systems, offering extensive configuration options and a variety of functionalities.

## Facts

- Repository: https://github.com/google/adk-python
- Homepage: https://google.github.io/adk-docs/
- Stars: 20,508 · Forks: 3,658 · Open issues: 701 · Watchers: 149
- Primary language: Python
- License: Apache-2.0
- Last pushed: 2026-07-07T16:31:11+00:00

## Categories

- [AI Agents](/categories/ai-agents.md)

## Tags

agents-sdk, multi-agents, agentic, agent

## Related tools

- [ECC](/tools/affaan-m-ecc.md) - The agent harness performance optimization system (★ 226,962)
- [hermes-agent](/tools/nousresearch-hermes-agent.md) - The self-improving AI agent built by Nous Research (★ 210,880)
- [AutoGPT](/tools/significant-gravitas-autogpt.md) - AutoGPT: Build, Deploy, and Run AI Agents (★ 185,417)
- [ollama](/tools/ollama-ollama.md) - Get up and running with Kimi-K2.6, GLM-5.1, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other models. (★ 175,659)
- [langflow](/tools/langflow-ai-langflow.md) - Langflow is a powerful platform for building and deploying AI-powered agents and workflows. (★ 151,298)
- [dify](/tools/langgenius-dify.md) - Production-ready platform for agentic workflow development (★ 148,070)
- [firecrawl](/tools/firecrawl-firecrawl.md) - The API to search, scrape, and interact with the web at scale. (★ 147,117)
- [langchain](/tools/langchain-ai-langchain.md) - The agent engineering platform. (★ 141,211)

## README (excerpt)

```text
# Agent Development Kit (ADK) 2.0








<h2 align="center">
  <img src="https://raw.githubusercontent.com/google/adk-python/main/assets/agent-development-kit.png" width="256"/>
</h2>
<h3 align="center">
  An open-source, code-first Python framework for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
</h3>
<h3 align="center">
  Important Links:
  <a href="https://google.github.io/adk-docs/">Docs</a>,
  <a href="https://github.com/google/adk-samples">Samples</a> &
  <a href="https://github.com/google/adk-web">ADK Web</a>.
</h3>

______________________________________________________________________

> **⚠️ BREAKING CHANGES FROM 1.x**
>
> This release includes breaking changes to the agent API, event model, and
> session schema. **Sessions generated by ADK 2.0 are readable by ADK 1.28+
> (extra fields will be ignored), but are incompatible with older 1.x versions.**

______________________________________________________________________

## 🔥 What's New in 2.0

- **Workflow Runtime**: A graph-based execution engine for composing
  deterministic execution flows for agentic apps, with support for routing,
  fan-out/fan-in, loops, retry, state management, dynamic nodes,
  human-in-the-loop, and nested workflows.

- **Task API**: Structured agent-to-agent delegation with multi-turn task
  mode, single-turn controlled output, mixed delegation patterns,
  human-in-the-loop, and task agents as workflow nodes.

## 🚀 Installation

```bash
pip install google-adk
```

**Requirements:** Python 3.10+.

To install optional integrations, you can use the following command:

```bash
pip install "google-adk[extensions]"
```

The release cadence is roughly bi-weekly.

## Quick Start

> **Beginner Note:** ADK applications are built using two main classes:
> **`Agent`** (defines an AI's instructions, tools, and behavior) and
> **`Workflow`** (orchestrates agents and tasks in a graph-based flow).

### Agent

```python
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.",
)
```

### Workflow

```python
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

```bash
# Interactive CLI
adk run path/to/my_agent

# Web UI (supports multi-agent directories or pointing directly to a single agent folder)
adk web path/to/agents_dir
```

## 📚 Documentation

- **Getting Started**: https://google.github.io/adk-docs/
- **Samples**: See `contributing/workflow_samples/` and
  `contributing/task_samples/` for workflow and task API examples.

## 🤝 Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## 📄 License

This project is licensed under the Apache 2.0 License — see the
[LICENSE](LICENSE) file for details.
```

---

**Machine-readable endpoints**

- JSON: [`/api/graphcanon/tools/google-adk-python`](/api/graphcanon/tools/google-adk-python)
- LLM index: [/llms.txt](/llms.txt)
- Full corpus: [/llms-full.txt](/llms-full.txt)

_GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_