a2a-handler 0.1.6

An A2A Protocol client TUI and CLI.

Handler

An A2A Protocol client TUI and CLI.

Install

Install with uv:

uv tool install a2a-handler

Or run directly without installing:

uvx --from a2a-handler handler

Use

Then, 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.