a2a-handler 0.1.8

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

Global Options

handler --verbose  # Enable verbose logging output
handler --debug    # Enable debug logging output
handler --help     # Show help for any command

Commands

Fetch agent card from A2A server:

handler card http://localhost:8000
handler card http://localhost:8000 --output json  # JSON output

Validate an agent card from a URL or file:

handler validate http://localhost:8000             # Validate from URL
handler validate ./agent-card.json                 # Validate from file
handler validate http://localhost:8000 --output json  # JSON output

Send a message to an A2A agent:

handler send http://localhost:8000 "Hello World"
handler send http://localhost:8000 "Hello" --output json    # JSON output
handler send http://localhost:8000 "Hello" --context-id abc # Conversation continuity
handler send http://localhost:8000 "Hello" --task-id xyz    # Reference existing task

Show version:

handler version

Contributing

See CONTRIBUTING.md for architecture and development instructions.