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.1

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.1
File	Size	Uploaded
a2a_sdk-0.3.1.tar.gz	216.7 kB	Aug 13, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for a2a-sdk 0.3.1
File	Interpreter	ABI	Platform	Reset
a2a_sdk-0.3.1-py3-none-any.whl 133.2 kB Aug 13, 2025	Python 3	none	any	Details

Total release size: 349.9 kB

Release files / a2a_sdk-0.3.1.tar.gz

Download URL	a2a_sdk-0.3.1.tar.gz
Size	216.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`962099062279073a1b5ecd91666f2b0a1db90eb971436fba804af82173d2e305`
BLAKE2b-256 checksum How to use checksums	`94a362e9bff37a4cb55c6d6fc59a732a9f07e95e66e13cdb4f0c53707d8ad8da`
Upload date	Aug 13, 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/26f24be52944088e48f74b0321271b28eb3d6ceb

Workflow

Publishing configuration: github.com/a2aproject/a2a-python/blob/26f24be52944088e48f74b0321271b28eb3d6ceb/.github/workflows/python-publish.yml
Publishing logs: github.com/a2aproject/a2a-python/actions/runs/16941905679/attempts/1

Artifact

Subject: a2a_sdk-0.3.1.tar.gz
SHA-256 checksum: 962099062279073a1b5ecd91666f2b0a1db90eb971436fba804af82173d2e305 Verifying attestations

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

Download URL	a2a_sdk-0.3.1-py3-none-any.whl
Size	133.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`904bb1b58d8ace6382a9c4c279d102267c5cda393f4ab42583fdb63551e1cd3b`
BLAKE2b-256 checksum How to use checksums	`841d6c25a110fbb558ee5c527a9477fbcf4656d7265e6bda62b45c19e9ff27a3`
Upload date	Aug 13, 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/26f24be52944088e48f74b0321271b28eb3d6ceb

Workflow

Publishing configuration: github.com/a2aproject/a2a-python/blob/26f24be52944088e48f74b0321271b28eb3d6ceb/.github/workflows/python-publish.yml
Publishing logs: github.com/a2aproject/a2a-python/actions/runs/16941905679/attempts/1

Artifact

Subject: a2a_sdk-0.3.1-py3-none-any.whl
SHA-256 checksum: 904bb1b58d8ace6382a9c4c279d102267c5cda393f4ab42583fdb63551e1cd3b Verifying attestations