# a2a-registry

**Repository Path**: statsmind/a2a-registry

## Basic Information

- **Project Name**: a2a-registry
- **Description**: A2A Registry
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-25
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# A2A Registry

A lightweight service for A2A agent discovery and request proxying.

## Features

- **Agent Discovery**: List and search registered agents.
- **Transparent Proxy**: Access any agent via a single entry point.
- **Persistence**: Agents are persisted to `~/.hermes/registry.json`.

## Installation

```bash
pip install git+https://github.com/YOUR-ORG/a2a-registry.git
```

## Usage

### Start the Registry Server

```bash
a2a-registry --port 8370
```

### Agent Discovery

```bash
# List all agents
curl http://localhost:8370/agents

# Get agent details
curl http://localhost:8370/agents/<agent_id>
```

### Agent Proxy

Once agents register, access them via the registry proxy:

```bash
# Access agent card
curl http://localhost:8370/<agent_id>/.well-known/agent.json

# Send message via JSON-RPC
curl -X POST http://localhost:8370/<agent_id>/v1/a2a \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "message/send",
    "params": {
      "message": { "role": "user", "parts": [{"text": "Hello"}] }
    },
    "id": 1
  }'
```

## API Reference

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/` | GET | Health check and agent listing |
| `/agents` | GET | List all agents |
| `/agents` | POST | Register an agent (JSON body: `{"agent_id": "...", "endpoint": "...", "agent_card": {...}}`) |
| `/agents/{agent_id}` | GET | Get agent details |
| `/agents/{agent_id}` | DELETE | Unregister an agent |
| `/{agent_id}/*` | * | Transparent proxy to the agent's endpoint |