repowisegoogle/adk-python

Architecture of google/adk-python

google/adk-python is 2,369 source files holding 24,391 symbols across 5 modules, written mainly in Python, JavaScript, Terraform. The largest module is src, with 798 files, and 59 files are entry points into the dependency graph.

How adk-python fits together

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.

Largest modules

  • src: 798 files and 132,859 lines of code
  • contributing: 741 files and 48,017 lines of code
  • tests: 721 files and 223,922 lines of code
  • .agents: 54 files and 5,811 lines of code
  • .github: 22 files and 1,676 lines of code
  • docs: 18 files and 1,816 lines of code
  • scripts: 8 files and 1,214 lines of code
  • root: 6 files and 3,258 lines of code

Languages

By file count: Python 1,751 files, JavaScript 101 files, Terraform 7 files, Shell 6 files, Dockerfile 1 file.

Documentation

Repowise documents adk-python in 2,736 pages generated from the source.

More on adk-python: summary and FAQ, codebase overview, code health.

Related guide: Best dependency graph tools for monorepos