A minimal template for building A2A (Agent-to-Agent) agents.

src/
├─ server.py      # Server setup and agent card configuration
├─ executor.py    # A2A request handling
├─ agent.py       # Your agent implementation goes here
└─ messenger.py   # A2A messaging utilities
Dockerfile        # Docker configuration
pyproject.toml    # Python dependencies
uv.lock           # Locked dependencies

1. Create your repository - Click "Use this template" to create your own repository from this template

2. Implement your agent - Add your agent logic to the run method in src/agent.py

3. Configure your agent card - Fill in your agent's metadata (name, skills, description) in src/server.py

# Install dependencies
uv sync

# Run the server
uv run src/server.py

# Build the image
docker build -t my-agent .

# Run the container
docker run -p 9009:9009 my-agent

The repository includes a GitHub Actions workflow that automatically builds and publishes a Docker image of your agent to GitHub Container Registry:

• Push to main → publishes latest tag:

ghcr.io/<your-username>/<your-repo-name>:latest

• Create a git tag (e.g. git tag v1.0.0 && git push origin v1.0.0) → publishes version tags:

ghcr.io/<your-username>/<your-repo-name>:1.0.0
ghcr.io/<your-username>/<your-repo-name>:1