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

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

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 install with gRPC support:

uv add "a2a-sdk[grpc]"

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]"

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

pip install a2a-sdk

To install with gRPC support:

pip install "a2a-sdk[grpc]"

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]"

1. Run Remote Agent

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

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

See CONTRIBUTING.md for contribution guidelines.