Adk Setup
Bootstrap a contributor-ready ADK Python repo with uv, extras, pre-commit, tox, and a passing test smoke check.
Overview
adk-setup is an agent skill for the Build phase that configures a local ADK Python development environment with uv, hooks, and test verification.
Install
npx skills add https://github.com/google/adk-python --skill adk-setupWhat is this skill?
- Hard gate: Python 3.11+ and uv required—explicitly avoid pip/venv-only flows
- uv venv, uv sync --all-extras, pre-commit and tox-uv via uv tool install
- Optional addlicense install via Go with clear blocker message if Go is missing
- pre-commit install step and verify-by-running-tests completion path
- disable-model-invocation: true—human-driven setup skill from project root
- Python 3.11+ required
- 8 numbered setup steps in skill body
Adoption & trust: 1 installs on skills.sh; 20k GitHub stars; 2/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
What problem does it solve?
You cloned ADK Python but lack the maintainer-prescribed uv toolchain, extras, and pre-commit hooks to contribute safely.
Who is it for?
Developers preparing to hack or contribute to the google/adk-python repository on macOS/Linux with shell access.
Skip if: Users who only pip-install adk in an application repo and never touch the ADK source tree.
When should I use this skill?
User wants to get started developing, set up their environment, install dependencies, or prepare for contributing to ADK Python.
What do I get? / Deliverables
Your machine has an activated .venv with all extras, dev tools installed, hooks registered, and tests run to confirm the tree is healthy.
- .venv with synced dependencies
- pre-commit hooks installed
- Verified test run
Recommended Skills
Journey fit
Local toolchain setup happens before you implement agents—canonical shelf is Build under agent tooling for the ADK project itself. Installing uv sync, hooks, and verification tests is environment prep for agent framework development, not shipping or growth work.
How it compares
Project-local bootstrap workflow—not a generic Python tutorial and not an MCP server install.
Common Questions / FAQ
Who is adk-setup for?
Contributors and advanced solo builders setting up the ADK Python monorepo locally before agent feature work or pull requests.
When should I use adk-setup?
At the start of Build on a fresh clone, or after wiping .venv when dependencies or Python version requirements change.
Is adk-setup safe to install?
It runs standard open-source dev commands; review the Security Audits panel on this page and only execute steps you trust from the official repo.
SKILL.md
READMESKILL.md - Adk Setup
Set up the local development environment for ADK Python. ## Prerequisites Check the following before proceeding: 1. **Python 3.11+** ```bash python3 --version ``` 2. **uv package manager** (required — do not use pip/venv directly) ```bash uv --version ``` If not installed: ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` ## Setup Steps Run these commands from the project root: 3. **Create and activate a virtual environment:** ```bash uv venv --python "python3.11" ".venv" source .venv/bin/activate ``` 4. **Install all dependencies for development:** ```bash uv sync --all-extras ``` 5. **Install development tools:** ```bash uv tool install pre-commit uv tool install tox --with tox-uv ``` 6. **Install addlicense (requires Go):** ```bash go version && go install github.com/google/addlicense@latest ``` > [!NOTE] > If Go is not installed, tell the user: > "Go is required for the addlicense tool. Please install Go from https://go.dev/dl/ and then re-run the `adk-setup` skill to complete the setup." 7. **Set up pre-commit hooks:** ```bash pre-commit install ``` 8. **Verify everything works by running tests locally:** ```bash pytest tests/unittests -n auto ``` ## Key Commands Reference | Task | Command | | :----------------------------------- | :------------------------------------------------ | | Run unit tests (Fast) | `pytest tests/unittests` | | Run tests across all Python versions | `tox` | | Format codebase | `pre-commit run --all-files` | | Run tests in parallel | `pytest tests/unittests -n auto` | | Run specific test file | `pytest tests/unittests/agents/test_llm_agent.py` | | Launch web UI | `adk web path/to/agents_dir` | | Run agent via CLI | `adk run path/to/my_agent` | | Build wheel | `uv build` |