# google/adk-python

> adk-python is an open-source, code-first Python framework for building, evaluating, and deploying AI agents. Developers define an agent in Python code by giving it a name, a model, and instructions, and tools and behavior can be added to it. Agents can be composed into graph-based workflows that handle routing, loops, retries, and human-in-the-loop steps. The project is written in Python and installed from PyPI as google-adk.

Source: https://github.com/google/adk-python
Indexed: commit f4fd7d5 on 2026-08-11 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: Python
- Stars: 22,230 at index time
- License: Apache-2.0
- Code health: 6.7/10, Fair
- Last commit: 2026-08-11
- Contributors: 100

## Install

From the README: https://github.com/google/adk-python#-installation

Install the package from PyPI.
    pip install google-adk

Run an agent in the interactive CLI.
    adk run path/to/my_agent

Start the web UI for an agents directory.
    adk web path/to/agents_dir

## How it works

Agents are defined in Python with the Agent class from google.adk, which takes a name, a model, and an instruction. The Workflow runtime orchestrates agents and tasks as a graph, supporting routing, fan-out and fan-in, loops, and nested workflows. The src directory holds the package code, including the google/adk/plugins module and its bigquery_agent_analytics_plugin.py file. Agents are run through the adk command, where adk run starts an interactive CLI and adk web starts a web UI for an agents directory. The docs/guides directory covers agents, tools, events, plugins, and workflows, and contributing/samples contains runnable example agents such as contributing/samples/adk_team/adk_answering_agent/main.py. Unit tests are kept under tests/unittests.

- .agents/skills/adk-verify-snippets/scripts/run.py: entry point
- contributing/samples/adk_team/adk_answering_agent/main.py: entry point
- contributing/samples/adk_team/adk_documentation/adk_docs_updater/main.py: entry point
- contributing/samples/adk_team/adk_documentation/adk_release_analyzer/main.py: entry point
- contributing/samples/adk_team/adk_issue_monitoring_agent/main.py: entry point
Modules: src, contributing, tests, .agents, .github, docs, scripts, root. 2,369 files, 418,576 lines, 24,391 symbols.

## Code health

- Score: 6.7/10 (Fair)
- Rank: #168 of 4,000+ indexed repos
- Hotspots: tests/unittests/artifacts/test_artifact_service.py, tests/unittests/agents/test_remote_a2a_agent.py, src/google/adk/plugins/bigquery_agent_analytics_plugin.py, tests/unittests/flows/llm_flows/test_request_confirmation.py, tests/unittests/tools/test_agent_tool.py
- Lowest file: src/google/adk/flows/llm_flows/functions.py
- Dead code: 155 findings

## Maintenance

- Last commit 2026-08-11, first commit 2026-07-06, 500 commits
- 100 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/google/adk-python/security

## More

- Page: https://repowise.dev/repo/google/adk-python
- Ask this codebase: https://repowise.dev/repo/google/adk-python/chat
- Docs: https://repowise.dev/repo/google/adk-python/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/google/adk-python
