Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
A Python library for running agentic applications as A2A Servers, following the Agent2Agent (A2A) Protocol.
- A2A Protocol Compliant: Build agentic applications that adhere to the Agent2Agent (A2A) Protocol.
- Extensible: Easily add support for different communication protocols and database backends.
- Asynchronous: Built on modern async Python for high performance.
- Optional Integrations: Includes optional support for:
- HTTP servers (FastAPI, Starlette)
- gRPC
- OpenTelemetry for tracing
- SQL databases (PostgreSQL, MySQL, SQLite)
This SDK implements the A2A Protocol Specification 0.3.
Important
There is an alpha version available with support for both 1.0 and 0.3 versions. Development for this version is taking place in the 1.0-dev branch, tracked in #701.
| Transport | Client | Server |
|---|---|---|
| JSON-RPC | ✅ | ✅ |
| HTTP+JSON/REST | ✅ | ✅ |
| GRPC | ✅ | ✅ |
- Python 3.10+
- uv (recommended) or pip
Install the core SDK and any desired extras using your preferred package manager.
| Feature | uv Command | pip Command |
|---|---|---|
| Core SDK | uv add a2a-sdk | pip install a2a-sdk |
| All Extras | uv add "a2a-sdk[all]" | pip install "a2a-sdk[all]" |
| HTTP Server | uv add "a2a-sdk[http-server]" | pip install "a2a-sdk[http-server]" |
| gRPC Support | uv add "a2a-sdk[grpc]" | pip install "a2a-sdk[grpc]" |
| OpenTelemetry Tracing | uv add "a2a-sdk[telemetry]" | pip install "a2a-sdk[telemetry]" |
| Encryption | uv add "a2a-sdk[encryption]" | pip install "a2a-sdk[encryption]" |
| Vertex AI Task Store | uv add "a2a-sdk[vertex]" | pip install "a2a-sdk[vertex]" |
| Database Drivers | ||
| PostgreSQL | uv add "a2a-sdk[postgresql]" | pip install "a2a-sdk[postgresql]" |
| MySQL | uv add "a2a-sdk[mysql]" | pip install "a2a-sdk[mysql]" |
| SQLite | uv add "a2a-sdk[sqlite]" | pip install "a2a-sdk[sqlite]" |
| All SQL Drivers | uv add "a2a-sdk[sql]" | pip install "a2a-sdk[sql]" |
-
Run Remote Agent
git clone https://github.com/a2aproject/a2a-samples.git cd a2a-samples/samples/python/agents/helloworld uv run .
-
In another terminal, run the client
cd a2a-samples/samples/python/agents/helloworld uv run test_client.py -
You can validate your agent using the agent inspector. Follow the instructions at the a2a-inspector repo.
You can find a variety of more detailed examples in the a2a-samples repository:
Contributions are welcome! Please see the CONTRIBUTING.md file for guidelines on how to get involved.
This project is licensed under the Apache 2.0 License. See the LICENSE file for more details.