A setup guide for creating a local working copy of the open-source ADK Python toolkit, including its virtual environment, dependencies, code checks, and tests.

Use it when you need to set up, bootstrap, or repair an ADK Python repository checkout.

It avoids manually assembling the development environment and helps confirm that the checkout works before you start changing code.

adk-setup — Skill by google

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add skills/google/adk-python/adk-setup

Any agent

npx skills add google/adk-python --skill adk-setup

Clone the repo

git clone --depth 1 https://github.com/google/adk-python

Made for: Claude Code, Codex.

Per session 146 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 939 The whole file, excluding the scripts and references it only reads on demand.

Security scan C 2 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00146	$0.00939
Opus 5	$0.00073	$0.00469
Sonnet 5	$0.00029	$0.00188
Haiku 4.5	$0.00015	$0.00094

Measured 2d ago against content hash 3e76a0773469, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

adk-setup scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl -LsSf https://astral.sh/uv/install.sh | sh

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -LsSf https://astral.sh/uv/install.sh | sh

.agents/skills/adk-setup/SKILL.md · 116 lines

How it starts

The opening of the file, as written. The whole thing — 116 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ADK Python Development Setup

Set up a working adk-python checkout: a uv-managed virtual environment with every dependency extra, pre-commit hooks, and a green unit-test run.

Prerequisites

Python. ADK supports 3.10 through 3.14 (requires-python = ">=3.10" in pyproject.toml). These steps use 3.11, the version the repo's own tooling defaults to.
```
python3 --version
```
uv. Dependencies are pinned in uv.lock; a hand-rolled pip/venv environment will not reproduce the locked versions.
```
uv --version
```
Install it if missing:
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```

Setup

Run these from the repository root.

Create and activate the virtual environment:

uv venv --python "python3.11" ".venv"
source .venv/bin/activate

Install every dependency extra:
```
uv sync --all-extras
```
--all-extras is what pulls in the test and dev extras. Syncing only the default dependencies leaves pytest and the linters uninstalled.
Install pre-commit and tox as standalone tools:
```
uv tool install pre-commit
uv tool install tox --with tox-uv
```
Both are also in the dev extra; installing them as uv tools puts them on PATH so the git hook and multi-version test runs work without an activated venv.
Install addlicense (optional, requires Go):
```
go install github.com/google/addlicense@latest
```
Without it the pre-commit hook prints Warning: addlicense not installed, skipping and passes, so a missing Go toolchain does not block setup — CI catches missing license headers instead.
Install the git hooks:
```
pre-commit install
```
On each commit the hooks auto-format with isort, pyink, and mdformat, then run ruff, addlicense, codespell, and the repo's own compliance checks.
Verify the environment:

Read the full file on GitHub · 116 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2d ago First seen · 116 lines · 146 tokens per session scan C 3e76a0773469

Subscribe to this mod's changes

adk-setup is a skill published in the GitHub repository google/adk-python (21,331 stars, last pushed 2d ago), licensed Apache-2.0. It adds 146 tokens to every session and 939 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

E-commerce Git and workflow Testing agent agents agents-sdk ai ai-agents multi-agent-systems

normal-skill

A normal skill with a hyphen.

google/adk-java · 11 tokens

underscore-skill

A skill with an underscore.

google/adk-java · 9 tokens

root-skill

root skill.

google/adk-java · 6 tokens

a-b

conflicting skill 2.

google/adk-java · 8 tokens

gh-issues

Fetch GitHub issues, spawn sub-agents to implement fixes and open PRs, then monitor and address PR review comments. Usage: /gh-issues [owner/repo] [--label bug] [--limit 5] [--milestone v1.0] [--assignee @me] [--fork user/repo] [--watch] [--interval 5] [--reviews-only] [--cron] [--dry-run] [--model glm-5]…

google/adk-js · 116 tokens

algorithmic-art

Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright…

google/adk-js · 62 tokens

adk-setup