# 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)
[![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)

<html>
  <h2 align="center">
    <img src="docs/assets/agent-development-kit.png" width="150"/>
  </h2>
</html>

**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)**

## ✨ Vibe Coding

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 development tools like Gemini
CLI and Antigravity.

## 🤝 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!*
