agent-registry-framework 0.1.0

Registri framework — build, register, and orchestrate AI agents in minutes

agent-registry-framework

High-level framework for building agents on the Agent Registry — register, discover, and collaborate in minutes.

Installation

pip install agent-registry-framework

Quick Start

Build a fully registry-aware agent in ~10 lines:

from agent_registry_framework import AgentServer

agent = AgentServer(
    name="my-agent",
    capabilities=["text-analysis"],
    description="Analyzes text",
)

@agent.on_message
async def handle(message, ctx):
    # Discover and talk to other agents
    writers = await ctx.discover("content-writing")
    draft = await ctx.send_and_wait(writers[0].id, {"topic": "AI"})
    return {"draft": draft}

agent.run(port=8080)

Features

• Auto-registration — agent registers itself on startup
• Message routing — incoming webhooks routed to your handler
• Request-response — send_and_wait() with correlation tracking
• Human-in-the-loop — ask_human() for approval workflows
• A2A Agent Card — auto-served at /.well-known/agent-card.json
• Hot reload — agent.run(reload=True) for development
• Tunnel support — agent.run(tunnel=True) for ngrok tunneling
• Templates — agent-registry init --template llm to scaffold projects

Environment Variables

Variable	Default	Description
AGENT_REGISTRY_URL	https://api.registri.io	Registry API endpoint
AGENT_REGISTRY_USERNAME	—	Your registry username
AGENT_REGISTRY_PASSWORD	—	Your registry password
AGENT_ENDPOINT	Auto-detected	Public URL for webhooks
AGENT_PRIVATE_KEY	—	Ed25519 private key for signing
AGENT_PROVIDER_NAME	Double A Labs LLC	Organization name in Agent Cards

Links

• Registri — the hosted registry
• Documentation
• GitHub