https://github.com/alDuncanson/Handler
A2A Protocol client and developer toolkit.
https://github.com/alDuncanson/Handler
a2a a2a-cli a2a-client a2a-protocol a2a-server adk agent ai ai-agents cli litellm mcp mcp-server ollama pypi python tui uv
Last synced: 2 months ago
JSON representation
A2A Protocol client and developer toolkit.
- Host: GitHub
- URL: https://github.com/alDuncanson/Handler
- Owner: alDuncanson
- License: gpl-3.0
- Created: 2025-11-16T23:10:16.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-03-25T04:18:00.000Z (2 months ago)
- Last Synced: 2026-03-26T09:51:49.895Z (2 months ago)
- Topics: a2a, a2a-cli, a2a-client, a2a-protocol, a2a-server, adk, agent, ai, ai-agents, cli, litellm, mcp, mcp-server, ollama, pypi, python, tui, uv
- Language: Python
- Homepage: https://handler.alduncanson.com/introduction
- Size: 2.68 MB
- Stars: 39
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-a2a - Handler - A2A Protocol client and developer toolkit featuring an interactive TUI, CLI commands, MCP server integration, agent card inspection, and a bundled reference agent. (🛠️ Tools & Utilities)
README
# Handler
[](https://github.com/alDuncanson/handler/actions/workflows/ci.yml)
[](https://a2a-protocol.org/latest/)
[](https://pypi.org/project/a2a-handler/)
[](https://pypi.org/project/a2a-handler/)
[](https://pypi.org/project/a2a-handler/)
[](https://pepy.tech/projects/a2a-handler)
[](https://github.com/alDuncanson/handler/stargazers)
Handler is an open-source [A2A Protocol](https://github.com/a2aproject/A2A)
client and developer toolkit.
It provides a CLI and TUI for communicating with remote agents, an MCP server
for bridging AI assistants into the A2A ecosystem, a reference server agent
implementation, push notification support, and agent card validation. Whether
you're building agents, integrating with existing ones, or exploring
agent-to-agent communication, Handler gives you the observability and control
you need from your terminal.
## Who is Handler For?
Handler is for developers, researchers, and teams working with AI agents. If
you're building agents that speak A2A, Handler helps you test and debug them. If
you're integrating with existing A2A agents, Handler gives you a fast way to
explore their capabilities. If you want your AI assistant to communicate with
other agents, Handler's MCP server bridges that gap. And if you're just curious
about agent-to-agent communication, Handler is a great place to start.
## Get Started
### Install
Install with [uv](https://github.com/astral-sh/uv):
```bash
uv tool install a2a-handler
```
Or with [pipx](https://pipx.pypa.io/):
```bash
pipx install a2a-handler
```
Or with pip:
```bash
pip install a2a-handler
```
### Run
Or, run from an ephemeral environment:
```bash
# With uv
uvx --from a2a-handler handler
# With pipx
pipx run a2a-handler
```
### Development Environment
A [hermetically sealed](https://zero-to-nix.com/concepts/hermeticity/)
development environment is available with
[Nix](https://zero-to-nix.com/concepts/nix/):
```bash
nix develop
```
This provides Python, uv, and just with all commands ready to use.
For usage documentation, see the
[Handler docs](https://alduncanson.github.io/Handler/).
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md).