A2A Python SDK

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

1. Run Remote Agent

   git clone https://github.com/google-a2a/a2a-samples.git
   cd a2a-samples/samples/python/agents/helloworld
   uv run .

2. In another terminal, run the client

   cd a2a-samples/samples/python/agents/helloworld
   uv run test_client.py

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