Metadata-Version: 2.4
Name: auraone-sdk
Version: 0.1.1
Summary: Official Python SDK and CLI for the AuraOne hosted API.
Author: AuraOne
License-Expression: MIT
Project-URL: Homepage, https://www.auraone.ai/developers
Project-URL: Documentation, https://www.auraone.ai/resources/docs
Project-URL: Source, https://github.com/auraoneai/sdk-python
Project-URL: Issues, https://github.com/auraoneai/sdk-python/issues
Keywords: auraone,sdk,evaluation,ai,human-feedback
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: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
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
Provides-Extra: async
Requires-Dist: httpx[http2]>=0.27.0; extra == "async"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: build>=1.0; extra == "dev"
Dynamic: license-file

# AuraOne Python SDK

Lightweight Python SDK and CLI for AuraOne APIs.

## Installation

```bash
pip install auraone-sdk

# Optional extras
pip install "auraone-sdk[async]"
pip install "auraone-sdk[dev]"
```

> For local development workflows, see `CONTRIBUTING.md` instead of using editable installs in production environments.

## CLI Usage

```
aura --base-url https://api.auraone.ai --org-id public --api-key test list-templates

aura --base-url https://api.auraone.ai evaluate \
  --template-id cartpole-v1 \
  --agent-bundle-url https://example.com/agent.zip \
  --wait --robust

aura --base-url https://api.auraone.ai quotas
aura --base-url https://api.auraone.ai system-health
```

## Client Usage

```python
from aura.client import AuraClient

client = AuraClient(api_key="test", base_url="https://api.auraone.ai", org_id="public")
templates = client.list_templates()
res = client.evaluate(template_id="cartpole-v1", agent_bundle_url="https://example.com/agent.zip", wait=False)
final = client.wait_for_completion(res.id, timeout_seconds=120)
```

## Features

- Retries/backoff on transient failures (HTTP 5xx/timeouts)
- Idempotent evaluation creation with `X-Idempotency-Key`
- Polling helpers to wait for terminal states
- Advanced endpoints: analytics, benchmarks, quotas, safety, admin
