AGENT SKILL

adk-setup

Sets up a local ADK Python development environment in a git clone of the open-source adk-python repository: a uv virtual environment, all dependency extras, pre-commit hooks, and a first unit-test run. Runs only when explicitly requested, never on its own. Use when asked to set up, bootstrap, or repair a development checkout, install project dependencies, fix a missing or broken .venv, or prepare a machine for contributing a pull request. Don't use for debugging a running agent (use adk-debug), for commit and pull-request mechanics (use adk-git), or for re-running formatters on a checkout that is already set up (pre-commit run --all-files).

License 许可
Apache-2.0
所属仓库
google/adk-python
最近更新
2026-11-14
Stars
★ 2.2w
Forks
4.4k

01 前言 Front Matter

name
adk-setup
description
Sets up a local ADK Python development environment in a git clone of the open-source adk-python repository: a uv virtual environment, all dependency extras, pre-commit hooks, and a first unit-test run. Runs only when explicitly requested, never on its own. Use when asked to set up, bootstrap, or repair a development checkout, install project dependencies, fix a missing or broken .venv, or prepare a machine for contributing a pull request. Don't use for debugging a running agent (use adk-debug), for commit and pull-request mechanics (use adk-git), or for re-running formatters on a checkout that is already set up (pre-commit run --all-files).
disable-model-invocation
true

03 SKILL.md 正文

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

  1. Python. ADK supports 3.11 through 3.15 (requires-python = ">=3.11" in pyproject.toml). These steps use 3.11, the version the repo's own tooling defaults to.

    python3 --version
    
  2. uv. Dependencies are declared in pyproject.toml. The uv sync step below creates a local uv.lock, which this repository ignores. Run that step before tox, whose lock runner requires the file.

    uv --version
    

    Install it if missing:

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

Setup

Run these from the repository root.

  1. Create and activate the virtual environment:

    uv venv --python "python3.11" ".venv"
    source .venv/bin/activate
    
  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. Verify the environment:

    pytest tests/unittests -n auto
    

    A green run here is the success criterion for setup. -n auto needs pytest-xdist, which arrives with the test extra in step 2.

Key commands

Task Command
Run unit tests pytest tests/unittests
Run unit tests in parallel pytest tests/unittests -n auto
Run one test file pytest tests/unittests/agents/test_base_agent.py
Run tests on every supported Python tox (uv downloads any missing interpreters)
Format and lint everything pre-commit run --all-files
Launch the web UI adk web {agents_dir}
Run an agent from the CLI adk run {agent_dir}
Build the wheel uv build

04 同仓库更多 Skills

google
google/adk-python

bigquery-graph

Skill for Graph Query Language (GQL) or SQL/PGQ queries against a property graph. Includes path finding, multi-hop traversal, topological connection, shortest path, node reachability, edge connectivity, and semantic graph queries.

数据分析师Skill与智能体开发
★ 2.2w
google
google/adk-python

bigquery-ai-ml

Leverages BigQuery's built-in machine learning and GenAI capabilities for advanced data analytics. Use when you need to write SQL queries that perform time-series forecasting, predict values, detect outliers or anomalies, find key drivers, perform semantic search or vector search, classify text, calculate similarity, summarize content, translate language, evaluate models, filter by semantic conditions, measure the causal effect of an intervention, compute correlations between columns, detect change points or structural breaks, extract trend or seasonality components, or leverage generative AI capabilities in BigQuery. Do not use for general BigQuery dataset, table, or job management requests.

数据分析师
★ 2.2w
google
google/adk-python

code-review-skill

Reviews code with feedback tailored to the developer's profile in session state.

开发工程师代码审查Skill与智能体开发
★ 2.2w
google
google/adk-python

weather-skill

A skill that provides weather information based on reference data.

Skill与智能体开发
★ 2.2w
google
google/adk-python

weather-skill

A skill that provides weather information based on reference data and scripts.

Skill与智能体开发
★ 2.2w
google
google/adk-python

weather-skill

A skill that provides weather information based on reference data.

Skill与智能体开发
★ 2.2w