From 0c75a0b494be7c55348bec7f8ae8919edc2ec5c3 Mon Sep 17 00:00:00 2001 From: shx815 Date: Sun, 8 Nov 2026 21:11:08 +0800 Subject: [PATCH 1/2] Python: Clarify A2A quickstart working directories --- python/samples/04-hosting/a2a/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/python/samples/04-hosting/a2a/README.md b/python/samples/04-hosting/a2a/README.md index 730ca702704..964fc1acb6e 100644 --- a/python/samples/04-hosting/a2a/README.md +++ b/python/samples/04-hosting/a2a/README.md @@ -32,7 +32,7 @@ in application code. The helper package does not choose a web framework. ## Quick Start -All commands below should be run from this directory: +For the server setup, start at the repository root and change to this directory: ```powershell cd python/samples/04-hosting/a2a @@ -77,7 +77,7 @@ You can run one agent or all three — each listens on its own port. ### 2. Run a Client -Once a server is running, use any of the client samples in [`samples/02-agents/a2a/`](../../02-agents/a2a/): +Once a server is running, open a separate terminal at the repository root. Then run a client from [`samples/02-agents/a2a/`](../../02-agents/a2a/): ```powershell cd python/samples/02-agents/a2a From 2d2ef1f656f04d470d02e567289c91b3cd7c0efb Mon Sep 17 00:00:00 2001 From: shx815 Date: Fri, 13 Nov 2026 00:14:17 +0800 Subject: [PATCH 2/2] Docs: prepare pip environment for the A2A client --- python/samples/04-hosting/a2a/README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/python/samples/04-hosting/a2a/README.md b/python/samples/04-hosting/a2a/README.md index 964fc1acb6e..b38a58a8639 100644 --- a/python/samples/04-hosting/a2a/README.md +++ b/python/samples/04-hosting/a2a/README.md @@ -77,7 +77,20 @@ You can run one agent or all three — each listens on its own port. ### 2. Run a Client -Once a server is running, open a separate terminal at the repository root. Then run a client from [`samples/02-agents/a2a/`](../../02-agents/a2a/): +Once a server is running, open a separate terminal at the repository root. + +**Option A — pip:** Activate the virtual environment created during server setup +in this terminal, then install the `agent-framework-a2a` client package from the +checkout: + +```powershell +.\python\samples\04-hosting\a2a\.venv\Scripts\Activate.ps1 # Windows +# source ./python/samples/04-hosting/a2a/.venv/bin/activate # macOS / Linux +python -m pip install -e ./python/packages/a2a +``` + +Run a client from [`samples/02-agents/a2a/`](../../02-agents/a2a/). For Option A, +use `python agent_with_a2a.py` as described above. ```powershell cd python/samples/02-agents/a2a