Description
The python/samples/04-hosting/a2a/ sample has no requirements.txt file. Unlike every other sample in 04-hosting/, a beginner who creates a .venv and tries pip install has no dependency file to reference.
The README recommends uv run python a2a_server.py, which only works when executed from the repo root with the uv workspace properly configured — a setup most beginners won't have.
Steps to Reproduce
cd python/samples/04-hosting/a2a
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt # ❌ File not found
Verified Missing Dependencies
Confirmed via import tests in a clean .venv:
| Package |
Import That Fails |
agent-framework-a2a |
from agent_framework.a2a import A2AAgent → ModuleNotFoundError: The 'agent-framework-a2a' package is not installed |
uvicorn |
import uvicorn → ModuleNotFoundError: No module named 'uvicorn' |
agent-framework-foundry |
Needed for FoundryChatClient in a2a_server.py |
httpx |
Used in agent_with_a2a.py |
python-dotenv |
Used across all scripts |
Also Missing
- No
.env.example or .env.template file. Users must read source code to discover FOUNDRY_PROJECT_ENDPOINT, FOUNDRY_MODEL, and A2A_AGENT_HOST.
Suggested Fix
- Add a
requirements.txt with local editable paths (matching the pattern used in durabletask/ and azure_functions/ samples).
- Add a
.env.example with the required environment variables.
Environment
- Python 3.13.13, Windows 11, uv 0.9.27
Description
The
python/samples/04-hosting/a2a/sample has norequirements.txtfile. Unlike every other sample in04-hosting/, a beginner who creates a.venvand triespip installhas no dependency file to reference.The README recommends
uv run python a2a_server.py, which only works when executed from the repo root with theuvworkspace properly configured — a setup most beginners won't have.Steps to Reproduce
Verified Missing Dependencies
Confirmed via import tests in a clean
.venv:agent-framework-a2afrom agent_framework.a2a import A2AAgent→ModuleNotFoundError: The 'agent-framework-a2a' package is not installeduvicornimport uvicorn→ModuleNotFoundError: No module named 'uvicorn'agent-framework-foundryFoundryChatClientina2a_server.pyhttpxagent_with_a2a.pypython-dotenvAlso Missing
.env.exampleor.env.templatefile. Users must read source code to discoverFOUNDRY_PROJECT_ENDPOINT,FOUNDRY_MODEL, andA2A_AGENT_HOST.Suggested Fix
requirements.txtwith local editable paths (matching the pattern used indurabletask/andazure_functions/samples)..env.examplewith the required environment variables.Environment