google

google/adk-docs

An open-source, code-first toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.

View on GitHub Website / Demo Back to listing

1.5kstars 1.5kforks 100+contributors Shell

README.md

View on GitHub

# Agent Development Kit (ADK)

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
[![PyPI](https://img.shields.io/pypi/v/google-adk)](https://pypi.org/project/google-adk/)
[![NPM Version](https://img.shields.io/npm/v/@google/adk)](https://www.npmjs.com/package/@google/adk)
[![Go Doc](https://img.shields.io/badge/Go%20Package-Doc-blue.svg)](https://pkg.go.dev/google.golang.org/adk/v2)
[![Maven Central Java](https://img.shields.io/maven-central/v/com.google.adk/google-adk)](https://search.maven.org/artifact/com.google.adk/google-adk)
[![Maven Central Kotlin](https://img.shields.io/maven-central/v/com.google.adk/google-adk-kotlin-core)](https://search.maven.org/artifact/com.google.adk/google-adk-kotlin-core)

**An open-source, code-first toolkit for building, evaluating, and
deploying sophisticated AI agents with flexibility and control.**

Agent Development Kit (ADK) is a flexible and modular framework for **developing
and deploying AI agents**. While optimized for Gemini and the Google ecosystem,
ADK is **model-agnostic**, **deployment-agnostic**, and is built for
**compatibility with other frameworks**. ADK was designed to make agent
development feel more like software development, to make it easier for
developers to create, deploy, and orchestrate agentic architectures that range
from simple tasks to complex workflows.

---

## ✨ Key Features

- **Rich Tool Ecosystem**: Utilize pre-built tools, custom functions,
  OpenAPI specs, or integrate existing tools to give agents diverse
  capabilities, all for tight integration with the Google ecosystem.

- **Code-First Development**: Define agent logic, tools, and orchestration
  directly for ultimate flexibility, testability, and versioning.

- **Modular Multi-Agent Systems**: Design scalable applications by composing
  multiple specialized agents into flexible hierarchies.

- **Tracing and Monitoring**: Built-in agent observability for debugging and optimizing
  workflows.

- **Deploy Anywhere**: Easily containerize and deploy agents on Cloud Run or GKE, or
  scale seamlessly with Agent Runtime.

## 🚀 Usage

You can use Agent Development Kit (ADK) with your preferred language:

- **[Get started with ADK Python](https://adk.dev/get-started/python/)**

- **[Get started with ADK TypeScript](https://adk.dev/get-started/typescript/)**

- **[Get started with ADK Go](https://adk.dev/get-started/go/)**

- **[Get started with ADK Java](https://adk.dev/get-started/java/)**

- **[Get started with ADK Kotlin](https://adk.dev/get-started/kotlin/)**

## 📚 Documentation

Explore the full documentation for detailed guides on building, evaluating, and
deploying agents:

- **[Documentation](https://adk.dev)**

## ✨ Coding with AI

Accelerate your ADK agent development workflow with AI-assisted coding. ADK
provides optimized documentation context compatible with AI code editors:

- **[llms.txt](https://adk.dev/llms.txt)**: A structured index
  of ADK documentation, designed to help LLMs navigate and locate specific
  topics and guides.
- **[llms-full.txt](https://adk.dev/llms-full.txt)**: The
  comprehensive documentation reference, ideal for complex implementations or
  models with large context windows.

You can also visit our **[Coding with
AI](https://adk.dev/tutorials/coding-with-ai/)** guide for instructions on using
these files with AI coding tools via MCP servers.

## 🤝 Contributing

We welcome contributions from the community! Whether it's bug reports, feature
requests, documentation improvements, or code contributions, please see our
**[Contributing Guidelines](./CONTRIBUTING.md)** to get started.

## 📄 License

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

---

*Happy Agent Building!*

Repository info

Default branch: main
Latest version: —
Created: 02/04/2025
Last activity: 04/11/2026
License: Apache-2.0
Open issues: 356
Watchers: 26

Contributors

koverholt

188 contributions

joefernandez

172 contributions

happyhuman

51 contributions

kazunori279

49 contributions

zyantw

46 contributions