Skip to content

Python: [Samples][Python] a2a/ sample missing requirements.txt — beginners cannot install dependencies #5395

@leestott

Description

@leestott

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 A2AAgentModuleNotFoundError: The 'agent-framework-a2a' package is not installed
uvicorn import uvicornModuleNotFoundError: 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

  1. Add a requirements.txt with local editable paths (matching the pattern used in durabletask/ and azure_functions/ samples).
  2. Add a .env.example with the required environment variables.

Environment

  • Python 3.13.13, Windows 11, uv 0.9.27

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationpython

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions