Metadata-Version: 2.4
Name: agentregistry-py
Version: 0.1.0
Summary: Discover, version, and deploy production AI agents — the registry for your agent fleet
Project-URL: Homepage, https://github.com/naveenkumarbaskaran/agentregistry
Project-URL: Repository, https://github.com/naveenkumarbaskaran/agentregistry
Project-URL: Issues, https://github.com/naveenkumarbaskaran/agentregistry/issues
Author: Naveen Kumar Baskaran
License: Apache-2.0
Keywords: agents,deploy,discovery,enterprise,llm,registry,versioning
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: >=3.11
Provides-Extra: all
Requires-Dist: aiosqlite>=0.20; extra == 'all'
Requires-Dist: httpx>=0.27; extra == 'all'
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Provides-Extra: http
Requires-Dist: httpx>=0.27; extra == 'http'
Provides-Extra: sqlite
Requires-Dist: aiosqlite>=0.20; extra == 'sqlite'
Description-Content-Type: text/markdown

<div align="center">
  <img src="assets/banner.svg" alt="agentregistry" width="100%"/>
</div>

<div align="center">

[![CI](https://github.com/naveenkumarbaskaran/agentregistry/actions/workflows/ci.yml/badge.svg)](https://github.com/naveenkumarbaskaran/agentregistry/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/agentregistry-py.svg)](https://pypi.org/project/agentregistry-py/)
[![Python](https://img.shields.io/pypi/pyversions/agentregistry-py.svg)](https://pypi.org/project/agentregistry-py/)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)

</div>

---

**agentregistry** is the registry for your agent fleet — discover, version, and deploy production AI agents. Like PyPI, but for agents.

## Install

```bash
pip install agentregistry-py
pip install "agentregistry-py[http]"   # health checks
pip install "agentregistry-py[sqlite]" # persistent store
```

## Quickstart

```python
from agentregistry import AgentRegistry, AgentManifest

registry = AgentRegistry()

registry.publish(AgentManifest(
    id="acme.billing-agent",
    version="1.2.0",
    description="Handles billing for enterprise tenants",
    capabilities=["charge_card", "refund", "read_balance"],
    framework="langgraph",
    tags={"domain": "finance", "env": "prod"},
    policies=["acme.billing.v2"],
))

# Discover
agent = registry.get("acme.billing-agent")
results = registry.search(capability="charge_card")
results = registry.search(framework="langgraph", tags={"domain": "finance"})

# Version lifecycle
registry.deprecate("acme.billing-agent", "1.1.0")
registry.yank("acme.old-agent")
versions = registry.versions("acme.billing-agent")
```

## AgentManifest

| Field | Type | Description |
|---|---|---|
| `id` | str | Unique agent identifier |
| `version` | str | Semver version |
| `capabilities` | list[str] | What the agent can do |
| `framework` | str | langgraph / crewai / autogen / openai / custom |
| `policies` | list[str] | Required agentplane policy IDs |
| `tags` | dict | Arbitrary k/v for filtering |
| `health_check` | str | HTTP endpoint for health checks |

## Stack

```
agentplane     → control plane   (runtime policy, versioning, escalation)
agentregistry  → registry        (discover, version, deploy agents)  ← you are here
agentobserve   → observability   (unified view across all layers)
agenteval      → testing         (golden paths, adversarial, policy tests)
```

---

Apache 2.0 · Built for production enterprise agents
