• Repository

Meta

• License Expression: Apache-2.0
  SPDX License Expression
• Author: Google LLC
• Tags A2A , A2A Protocol , A2A SDK , Agent 2 Agent , Agent2Agent
• Requires: Python >=3.10
• Provides-Extra: all , db-cli , encryption , fastapi , grpc , http-server , mysql , postgresql , signing , sql , sqlite , telemetry

Classifiers

• Intended Audience
  • Developers
• License
  • OSI Approved :: Apache Software License
• Operating System
  • OS Independent
• Programming Language
  • Python
  • Python :: 3
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Python :: 3.14
• Topic
  • Software Development :: Libraries :: Python Modules

A2A Python SDK

👁 License
👁 PyPI version
👁 PyPI - Python Version
👁 PyPI - Downloads
👁 Python Unit Tests

👁 Ask Code Wiki

---

[!IMPORTANT] Upgrading the SDK from 0.3 to 1.0? See the v0.3 → v1.0 migration guide. For supported A2A spec versions, see Compatibility.

✨ 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 1.0, with compatibility mode for 0.3. See #742 for details on the compatibility scope.

Spec Version	Transport	Client	Server
1.0	JSON-RPC	✅	✅
1.0	HTTP+JSON/REST	✅	✅
1.0	gRPC	✅	✅
0.3 (compat)	JSON-RPC	✅	✅
0.3 (compat)	HTTP+JSON/REST	✅	✅
0.3 (compat)	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]"
FastAPI Integration	uv add "a2a-sdk[fastapi]"	pip install "a2a-sdk[fastapi]"
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]"
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

1. Run Remote Agent

   gitclonehttps://github.com/a2aproject/a2a-samples.git
   cda2a-samples/samples/python/agents/helloworld
   uvrun.
   

2. In another terminal, run the client

   cda2a-samples/samples/python/agents/helloworld
   uvruntest_client.py
   

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

Verified details

These details have been verified by PyPI

Project links

• changelog
• repository

GitHub Statistics

Maintainers

👁 Avatar for a2a_protocol from gravatar.com
a2a_protocol 👁 Avatar for herczyn from gravatar.com
herczyn 👁 Avatar for holt from gravatar.com
holt 👁 Avatar for ishymko from gravatar.com
ishymko

Unverified details

These details have not been verified by PyPI

Project links

• documentation
• homepage

• Download URL: a2a_sdk-1.1.0.tar.gz
• Upload date: May 29, 2026
• Size: 375.7 kB
• Tags: Source
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.13.13

Hashes for a2a_sdk-1.1.0.tar.gz

Algorithm	Hash digest
SHA256	e8102dad1b36709dbdc3d19319e38e6dfa3b3a79c30416030eb2d482576be204
MD5	907546870e65cfc37204ef50feb382d0
BLAKE2b-256	c77e8ac10bbf8b15b16574355f39b17dbdf617a282c27b41c7ff2116e30336df

See more details on using hashes here.

• Download URL: a2a_sdk-1.1.0-py3-none-any.whl
• Upload date: May 29, 2026
• Size: 241.9 kB
• Tags: Python 3
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.13.13

Hashes for a2a_sdk-1.1.0-py3-none-any.whl

Algorithm	Hash digest
SHA256	d7f5846caf18033d8bf3108b11ec827dd8dd32f867c98848ede0e39474be93be
MD5	de4cb486b42ad9367038ec0225e2dfe8
BLAKE2b-256	d4ea3a5b160cfd51c67759b08748051094d9365ceff18127633d0021950c9860

See more details on using hashes here.