Pre-release

This release is a pre-release and may not be stable for production use.

A2A Python SDK

PyPI - Python Version

A Python library for running agentic applications as A2A Servers, following the Agent2Agent (A2A) Protocol.

✨ Features

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)

🧩 Compatibility

This SDK implements the A2A Protocol Specification 0.3.

Transport	Client	Server
JSON-RPC	✅	✅
HTTP+JSON/REST	✅	✅
GRPC	✅	✅

🚀 Getting Started

Prerequisites

Python 3.10+
uv (recommended) or pip

🔧 Installation

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]"`

Examples

Helloworld Example

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.

🌐 More Examples

You can find a variety of more detailed examples in the a2a-samples repository:

Python Examples
JavaScript Examples

🤝 Contributing

Contributions are welcome! Please see the CONTRIBUTING.md file for guidelines on how to get involved.

📄 License

This project is licensed under the Apache 2.0 License. See the LICENSE file for more details.

Metadata

Release files for a2a-sdk 1.0.0a3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for a2a-sdk 1.0.0a3
File	Size	Uploaded
a2a_sdk-1.0.0a3.tar.gz	379.2 kB	Apr 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for a2a-sdk 1.0.0a3
File	Interpreter	ABI	Platform	Reset
a2a_sdk-1.0.0a3-py3-none-any.whl 237.0 kB Apr 17, 2026	Python 3	none	any	Details

Total release size: 616.2 kB

Release files / a2a_sdk-1.0.0a3.tar.gz

Download URL	a2a_sdk-1.0.0a3.tar.gz
Size	379.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`65483a01150718ab59d0a1216bf27fcd7d9547fa339e50447594afe791c29cea`
BLAKE2b-256 checksum How to use checksums	`8441a742f2e3c94ac7388bd43230e50079d7b9158331312bcccc5d149177a2c7`
Upload date	Apr 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/a2aproject/a2a-python
Publishing commit: github.com/a2aproject/a2a-python/tree/25e2a7d620524a2325744b7a559662b6c6d24c48

Workflow

Publishing configuration: github.com/a2aproject/a2a-python/blob/25e2a7d620524a2325744b7a559662b6c6d24c48/.github/workflows/python-publish.yml
Publishing logs: github.com/a2aproject/a2a-python/actions/runs/24573921277/attempts/1

Artifact

Subject: a2a_sdk-1.0.0a3.tar.gz
SHA-256 checksum: 65483a01150718ab59d0a1216bf27fcd7d9547fa339e50447594afe791c29cea Verifying attestations

Release files / a2a_sdk-1.0.0a3-py3-none-any.whl

Download URL	a2a_sdk-1.0.0a3-py3-none-any.whl
Size	237.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b915430ed5fe7ca7906da3e69f8cb1bef0f9ad9d7dfc4eb3a292384e4e02850b`
BLAKE2b-256 checksum How to use checksums	`3129215b8b9c7b9a99f6fbcabfb29ff009eeaadde69136454f8a8f3775b47d47`
Upload date	Apr 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/a2aproject/a2a-python
Publishing commit: github.com/a2aproject/a2a-python/tree/25e2a7d620524a2325744b7a559662b6c6d24c48

Workflow

Publishing configuration: github.com/a2aproject/a2a-python/blob/25e2a7d620524a2325744b7a559662b6c6d24c48/.github/workflows/python-publish.yml
Publishing logs: github.com/a2aproject/a2a-python/actions/runs/24573921277/attempts/1

Artifact

Subject: a2a_sdk-1.0.0a3-py3-none-any.whl
SHA-256 checksum: b915430ed5fe7ca7906da3e69f8cb1bef0f9ad9d7dfc4eb3a292384e4e02850b Verifying attestations