A2A Python SDK

PyPI - Version 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

Using `pip`

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

pip install a2a-sdk

Examples

Helloworld Example

Run Remote Agent

git clone https://github.com/google-a2a/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 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.2.6

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.2.6
File	Size	Uploaded
a2a_sdk-0.2.6.tar.gz	132.4 kB	Jun 9, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for a2a-sdk 0.2.6
File	Interpreter	ABI	Platform	Reset
a2a_sdk-0.2.6-py3-none-any.whl 86.6 kB Jun 9, 2025	Python 3	none	any	Details

Total release size: 218.9 kB

Release files / a2a_sdk-0.2.6.tar.gz

Download URL	a2a_sdk-0.2.6.tar.gz
Size	132.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`2625cedec823f0600980e0da8ddeec8181e5aafe095d73f430d694e16403b6f0`
BLAKE2b-256 checksum How to use checksums	`b45c01c751ceb5e9288d6738d23384924637383d000054eb5a21bc6b5bbfe5e3`
Upload date	Jun 9, 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/google-a2a/a2a-python
Publishing commit: github.com/google-a2a/a2a-python/tree/e744e6dc046aa43acfa7d8120444b912c9dac841

Workflow

Publishing configuration: github.com/google-a2a/a2a-python/blob/e744e6dc046aa43acfa7d8120444b912c9dac841/.github/workflows/python-publish.yml
Publishing logs: github.com/google-a2a/a2a-python/actions/runs/15539890302/attempts/1

Artifact

Subject: a2a_sdk-0.2.6.tar.gz
SHA-256 checksum: 2625cedec823f0600980e0da8ddeec8181e5aafe095d73f430d694e16403b6f0 Verifying attestations

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

Download URL	a2a_sdk-0.2.6-py3-none-any.whl
Size	86.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cfaadfde94c9e42cc2d610b7367cfc8cb6daf9a2afe400d5be8c832a7f64253e`
BLAKE2b-256 checksum How to use checksums	`eccfa4eb4d6cd6d29e7dd9224730de8ea93735aee468070f5e81e19dc7c3fdf3`
Upload date	Jun 9, 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/google-a2a/a2a-python
Publishing commit: github.com/google-a2a/a2a-python/tree/e744e6dc046aa43acfa7d8120444b912c9dac841

Workflow

Publishing configuration: github.com/google-a2a/a2a-python/blob/e744e6dc046aa43acfa7d8120444b912c9dac841/.github/workflows/python-publish.yml
Publishing logs: github.com/google-a2a/a2a-python/actions/runs/15539890302/attempts/1

Artifact

Subject: a2a_sdk-0.2.6-py3-none-any.whl
SHA-256 checksum: cfaadfde94c9e42cc2d610b7367cfc8cb6daf9a2afe400d5be8c832a7f64253e Verifying attestations