A2A Python SDK

PyPI - Python Version

A Python library that helps run agentic applications as A2AServers following the Agent2Agent (A2A) Protocol.

Installation

You can install the A2A SDK using either uv or pip.

Prerequisites

Python 3.10+
uv (optional, but recommended) or pip

Using `uv`

When you're working within a uv project or a virtual environment managed by uv, the preferred way to add packages is using uv add.

uv add a2a-sdk

To include the optional HTTP server components (FastAPI, Starlette), install the http-server extra:

uv add a2a-sdk[http-server]

To install with gRPC support:

uv add "a2a-sdk[grpc]"

To install with OpenTelemetry tracing support:

uv add "a2a-sdk[telemetry]"

To install with database support:

# PostgreSQL support
uv add "a2a-sdk[postgresql]"

# MySQL support
uv add "a2a-sdk[mysql]"

# SQLite support
uv add "a2a-sdk[sqlite]"

# All database drivers
uv add "a2a-sdk[sql]"

Using `pip`

If you prefer to use pip, the standard Python package installer, you can install a2a-sdk as follows

pip install a2a-sdk

To include the optional HTTP server components (FastAPI, Starlette), install the http-server extra:

pip install a2a-sdk[http-server]

To install with gRPC support:

pip install "a2a-sdk[grpc]"

To install with OpenTelemetry tracing support:

pip install "a2a-sdk[telemetry]"

To install with database support:

# PostgreSQL support
pip install "a2a-sdk[postgresql]"

# MySQL support
pip install "a2a-sdk[mysql]"

# SQLite support
pip install "a2a-sdk[sqlite]"

# All database drivers
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.

You can also find more Python samples here and JavaScript samples here.

License

This project is licensed under the terms of the Apache 2.0 License.

Contributing

See CONTRIBUTING.md for contribution guidelines.

Metadata

Release files for a2a-sdk 0.3.4

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 0.3.4
File	Size	Uploaded
a2a_sdk-0.3.4.tar.gz	220.2 kB	Sep 2, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for a2a-sdk 0.3.4
File	Interpreter	ABI	Platform	Reset
a2a_sdk-0.3.4-py3-none-any.whl 135.3 kB Sep 2, 2025	Python 3	none	any	Details

Total release size: 355.5 kB

Release files / a2a_sdk-0.3.4.tar.gz

Download URL	a2a_sdk-0.3.4.tar.gz
Size	220.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`79db4c287cab1235a0b0c5af9a3a58eedd8a037b51a87bed2e89f5e5e8977f65`
BLAKE2b-256 checksum How to use checksums	`cdcef50c904664a0fcafa0909be7a987ef6dcf1d75595532305bcefadb0532af`
Upload date	Sep 2, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

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/6941b0617a324074c9582c0c6202b1261043467b

Workflow

Publishing configuration: github.com/a2aproject/a2a-python/blob/6941b0617a324074c9582c0c6202b1261043467b/.github/workflows/python-publish.yml
Publishing logs: github.com/a2aproject/a2a-python/actions/runs/17410420858/attempts/1

Artifact

Subject: a2a_sdk-0.3.4.tar.gz
SHA-256 checksum: 79db4c287cab1235a0b0c5af9a3a58eedd8a037b51a87bed2e89f5e5e8977f65 Verifying attestations

Release files / a2a_sdk-0.3.4-py3-none-any.whl

Download URL	a2a_sdk-0.3.4-py3-none-any.whl
Size	135.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`423f72334b4a4b34cb4da07d5db3b786975de2fbc527236e3ca713b0d08c27e1`
BLAKE2b-256 checksum How to use checksums	`447ac7a13e692aba332fb55480c843acb7f3cf43668623f75d127792e8fa9b30`
Upload date	Sep 2, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Identity

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

Workflow

Publishing configuration: github.com/a2aproject/a2a-python/blob/6941b0617a324074c9582c0c6202b1261043467b/.github/workflows/python-publish.yml
Publishing logs: github.com/a2aproject/a2a-python/actions/runs/17410420858/attempts/1

Artifact

Subject: a2a_sdk-0.3.4-py3-none-any.whl
SHA-256 checksum: 423f72334b4a4b34cb4da07d5db3b786975de2fbc527236e3ca713b0d08c27e1 Verifying attestations