diff --git a/python/samples/04-hosting/a2a/README.md b/python/samples/04-hosting/a2a/README.md index 730ca702704..b38a58a8639 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,20 @@ 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. + +**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