Handler

An A2A Protocol client TUI and CLI.

Run

This project is managed with uv, so you can run Handler in a temporary, isolated environment:

uvx git+https://github.com/alDuncanson/handler

or, install it globally:

uv tool install git+https://github.com/alDuncanson/handler

Use

Now you can use Handler:

handler

If you don't have an A2A server to connect to, Handler provides a local A2A server agent:

handler server

The server agent requires Ollama to be running locally. By default it connects to http://localhost:11434 and uses the qwen3 model.

1. Install and run Ollama
2. Pull the model: ollama pull qwen3
3. (Optional) Configure via environment variables: OLLAMA_API_BASE and OLLAMA_MODEL

TUI

Interactive terminal user interface:

handler tui

CLI

Fetch agent card from A2A server:

handler card http://localhost:8000

Send a message to an A2A agent:

handler send http://localhost:8000 "Hello World"

Contributing

See CONTRIBUTING.md for architecture and development instructions.