PythonでAIエージェントを動かす前に、仮想環境の作成と依存関係の解決だけで半日を溶かした経験はありませんか。Google Cloud Techは2026年6月、Rust製パッケージマネージャー「uv」を使えばAgent Development Kit（ADK）の環境構築を一気に終えられると紹介しています。

この記事では、uvを使ったPythonエージェント開発環境の立ち上げ手順と、ADKを動かすまでの具体的なコマンドを整理します。

この記事でわかること

  • uvが従来のpip＋venvより速い理由と役割
  • ADKを入れるための最小コマンドセット
  • Agent Starter Packで本番向けプロジェクトを即座に作る方法
  • ローカルでエージェントを試すadk runとadk webの使い分け

なぜuvなのか

uvはAstral社が開発するオープンソースのPythonパッケージ・プロジェクトマネージャーです。Rustで実装されており、公式ドキュメントではpipより10〜100倍速いと説明されています。pip、pip-tools、pipx、poetry、virtualenvなどに相当する機能を1つのCLIにまとめ、依存関係の解決から仮想環境の作成、ロックファイル管理までを担います。

GoogleのADK開発リポジトリ（google/adk-python）でも、ローカル開発環境のセットアップにuvの利用が推奨されています。pipとvenvを直接使う従来の手順と比べ、環境の再現と依存関係の同期が短時間で終わる点が、エージェント開発の初期ハードルを下げます。

ADKとは何をするツールか

ADK（Agent Development Kit）は、Googleが公開するオープンソースのエージェント開発フレームワークです。Python 3.10以上が必要で、pip install google-adkで導入できます。エージェントの指示・ツール・振る舞いを定義するAgentクラスと、複数エージェントをグラフでつなぐWorkflowクラスが中核です。

2026年時点のADK 2.0では、ワークフロー実行エンジンやTask APIなど大きな機能追加があり、1.x系とはAPIやセッション形式に互換性のない変更が入っています。新規に環境を組むなら、最新版を前提に進めるのが安全です。

uvのインストール

https://docs.astral.sh/uv/getting-started/installation/

macOSやLinuxでは、公式インストーラーを使います。

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

インストール後、uv --versionで動作を確認します。Python本体がまだ入っていない場合も、uv python install 3.11のようにuv経由でPythonを取得できます。

手順1 仮想環境を作る

エージェント用のプロジェクトディレクトリを用意し、仮想環境を作成します。

mkdir my-agent && cd my-agent
uv venv --python 3.11 .venv
source .venv/bin/activate

uv venvは必要なPythonバージョンを自動で探し、.venv配下に隔離環境を作ります。ADKの開発リポジトリではPython 3.11を指定する例が示されています。

手順2 ADKを入れる

https://pypi.org/project/google-adk/

ADK本体はPyPIから取得します。uvのpip互換インターフェースを使うと、従来のpipコマンド感覚で導入できます。

uv pip install google-adk

拡張連携が必要ならuv pip install "google-adk[extensions]"とします。プロジェクト単位で管理する場合は、先にuv initでpyproject.tomlを作り、uv add google-adkで依存関係とロックファイルを同時に更新する方法もあります。

手順3 エージェントプロジェクトを生成する

ADKには対話的に雛形を作るadk createコマンドがあります。

adk create my_agent

generatedされるmy_agent/agent.pyにroot_agentを定義し、.envにGOOGLE_API_KEYを書けば、Gemini API経由で動かせます。APIキーはGoogle AI StudioのAPI Keysページで発行します。

本番デプロイまで見据えるなら、Agent Starter Packを使う手もあります。

https://googlecloudplatform.github.io/agent-starter-pack/guide/getting-started

uvx agent-starter-pack create

uvxはuv tool runの別名で、パッケージを恒久インストールせず一時環境でCLIを実行します。Agent Starter Packの公式ドキュメントでは、この1コマンドでテンプレート選択からバックエンド・フロントエンド・デプロイ用インフラまで含むプロジェクトが生成されると説明されています。テンプレートにadkを選べば、ADKベースのエージェントがすぐに手元に揃います。

手順4 ローカルで動かして確認する

環境が整ったら、CLIまたはWeb UIでエージェントを試します。

adk run my_agent
adk web --port 8000

adk runはターミナル上で対話テスト向けです。adk webはブラウザからチャットUIで試せますが、公式ドキュメントでは本番利用を想定していない開発・デバッグ専用と明記されています。adk webはエージェントフォルダの親ディレクトリから起動する点に注意が必要です。

Agent Starter Packで作ったプロジェクトなら、ディレクトリ内でmake installのあとmake playgroundを実行すると、adk webベースのローカル検証環境が立ち上がります。

pipとの使い分け

ADKの公式クイックスタートは依然としてpip install google-adkとpython -m venvを案内しています。既存プロジェクトをそのまま使うならpipでも問題ありません。

uvを選ぶメリットは、依存解決の速度、ロックファイルによる再現性、uv runで仮想環境の有効化を意識せずコマンドを実行できる点です。Google Cloud Techがuvを推す背景は、エージェント開発の「環境づくり」にかかる待ち時間を削る実務上の効果にあります。

つながる次の一手

GoogleはAgent Starter Packの後継としてagents-cliも公開しています。uvx google-agents-cli setupでCLIとコーディングエージェント向けスキルをまとめて入れられ、評価・デプロイ・オブザーバビリティまで一連のワークフローを扱えます。まずはuvでADKを動かし、要件が固まった段階でStarter Packやagents-cliへ広げる流れが現実的です。

環境構築はエージェントの価値そのものではありません。uvを使ってADKの導入を数分に圧縮し、プロンプト設計やツール連携といった本題に早く着手できる状態を作ることが、この記事のゴールです。