Metadata-Version: 2.5
Name: ageniko
Version: 0.1.1
Summary: The open trust boundary for AI agents — receipts, approval gates, and OTEL tracing in one decorator.
Project-URL: Homepage, https://github.com/ageniko-ai/ageniko
Project-URL: Documentation, https://docs.ageniko.dev
Project-URL: Repository, https://github.com/ageniko-ai/ageniko
License-Expression: Apache-2.0
Keywords: agents,ai,observability,opentelemetry,tracing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: opentelemetry-api>=1.27.0
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.27.0
Requires-Dist: opentelemetry-sdk>=1.27.0
Requires-Dist: pydantic-settings>=2.6.0
Requires-Dist: pydantic>=2.9.0
Provides-Extra: anthropic
Requires-Dist: opentelemetry-instrumentation-anthropic>=0.34.0; extra == 'anthropic'
Provides-Extra: dev
Requires-Dist: mypy>=1.11.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest>=8.3.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Provides-Extra: openai
Requires-Dist: opentelemetry-instrumentation-openai>=0.40.0; extra == 'openai'
Description-Content-Type: text/markdown

# ageniko

**The open trust boundary for AI agents.**

One decorator gives every agent action a receipt it can't forge and a gate it can't cross. Open-source, framework-agnostic, 30 seconds to first trace.

---

## Installation

```bash
pip install ageniko
```

## Quick Start

```python
from ageniko import instrument, check, approve, agent

# Initialize OTEL tracing
instrument()

# Add receipts to agent functions — proves what it claimed vs what it did
@check
def handle_ticket(ticket):
    result = process(ticket)
    return result

# Add approval gates — blocks before irreversible actions
@approve(when="irreversible")
def delete_account(user_id):
    db.delete_user(user_id)

# Full agent wrapper — tracing + receipts + cost tracking
@agent(name="support-agent", model="gpt-4o")
def run_agent(query):
    return llm.complete(query)
```

## What Ageniko Provides

| Feature | Description |
|---------|-------------|
| **Receipts** | Claimed vs. actual verdict on every run |
| **Approval Gates** | Deterministic block before irreversible actions |
| **Tracing** | OTEL-native, every span, tool call, token, cost |
| **Kill-Switch** | Budget, loop, and token caps per run |

## Self-Host

```bash
git clone https://github.com/ageniko-ai/ageniko
cd ageniko
cp .env.example .env
docker compose up
```

Open `http://localhost:3000` for the console.

## Pricing

| Tier | Price | Details |
|------|-------|---------|
| **Open Source** | $0 forever | Self-host, two containers |
| **Pro** | $49/mo | Managed cloud, silent-failure alerts |
| **Business** | $299/mo | SSO, RBAC, compliance export |
| **Enterprise** | From $1,500/mo | Self-hosted support, SLAs |

## Links

- [GitHub](https://github.com/ageniko-ai/ageniko)
- [Documentation](https://docs.ageniko.dev)
- [PyPI](https://pypi.org/project/ageniko/)

## License

Apache 2.0
