Metadata-Version: 2.4
Name: agentregistry
Version: 0.1.0
Summary: The neutral cross-platform registry for AI agents
Author-email: Aevon Systems <hello@agentregistry.dev>
License: MIT
Project-URL: Homepage, https://agentregistry.dev
Project-URL: Repository, https://github.com/aevonsystems/agentregistry-sdk
Project-URL: Documentation, https://agentregistry.dev/docs
Keywords: ai,agents,registry,discovery,multi-agent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27.0
Dynamic: license-file

# agentregistry

The neutral cross-platform registry for AI agents.

Register your agent once. Get discovered by any multi-agent system, any framework, any cloud.

## Installation

```bash
pip install agentregistry
```

## Quick start

### Discover an agent

```python
from agentregistry import Registry

agent = await Registry.find("search the web and return cited summaries")

if agent:
    print(agent.name)       # research-agent-v2
    print(agent.endpoint)   # https://myagent.com/api
    print(agent.framework)  # langgraph
```

### Register your agent

```python
from agentregistry import Registry

result = Registry.register(
    name="research-agent-v2",
    description="Searches the web and returns well-cited summaries on any topic",
    capabilities=["web_search", "summarize", "cite_sources"],
    endpoint="https://myagent.com/api",
    framework="langgraph",
)

print(result.agent_id)
print(result.api_key)  # Save this. Shown only once.
```

### Search for multiple agents

```python
agents = await Registry.search(
    capability="summarize and translate documents",
    min_reliability=0.95,
    limit=5,
)

for agent in agents:
    print(agent.name, f"{agent.similarity_score:.0%} match")
```

### Check agent health

```python
health = await Registry.health("your-agent-id")
print(health["status"])    # active
print(health["latency_ms"]) # 142
```

## Configuration

By default the SDK connects to the hosted AgentRegistry service.
You can point it at your own instance:

```python
Registry.configure(
    api_url="https://your-own-registry.com",
    api_key="ar_your_api_key"
)
```

Or use environment variables:

```bash
AGENTREGISTRY_API_URL=https://your-own-registry.com
AGENTREGISTRY_API_KEY=ar_your_api_key
```

## Links

- Registry: https://agentregistry.dev
- Docs: https://agentregistry.dev/docs
- GitHub: https://github.com/aevonsystems/agentregistry-sdk
