auraone-sdk 0.1.0__tar.gz

auraone_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AuraOne
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

auraone_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: auraone-sdk
+Version: 0.1.0
+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

auraone_sdk-0.1.0/README.md

@@ -0,0 +1,47 @@
+# 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

auraone_sdk-0.1.0/aura/__init__.py

@@ -0,0 +1,8 @@
+"""AuraOne Python SDK.
+
+This package provides the AuraOne client, CLI helpers, and integration shims.
+"""
+
+from .client import AuraClient
+
+__all__ = ["AuraClient"]

auraone_sdk-0.1.0/aura/cli.py

@@ -0,0 +1,61 @@
+import argparse
+import sys
+from typing import List
+from .client import AuraClient
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="aura")
+    parser.add_argument("--base-url", default="http://localhost:8000")
+    parser.add_argument("--org-id", default="public")
+    parser.add_argument("--api-key", default=None)
+
+    sub = parser.add_subparsers(dest="cmd", required=True)
+
+    sub.add_parser("list-templates")
+    sub.add_parser("quotas")
+    sub.add_parser("system-health")
+
+    eval_p = sub.add_parser("evaluate")
+    eval_p.add_argument("--template-id", required=True)
+    eval_p.add_argument("--agent-bundle-url", required=True)
+    eval_p.add_argument("--wait", action="store_true", default=False)
+    eval_p.add_argument("--robust", action="store_true", default=False)
+
+    return parser
+
+
+def run_cli(argv: List[str]) -> int:
+    args = build_parser().parse_args(argv)
+    client = AuraClient(api_key=args.api_key, base_url=args.base_url, org_id=args.org_id)
+
+    if args.cmd == "list-templates":
+        items = client.list_templates()
+        for t in items:
+            print(f"{t.id}\t{t.name}\t{t.version}\t{t.domain or ''}")
+        return 0
+
+    if args.cmd == "evaluate":
+        if args.robust:
+            res = client.evaluate_robust(template_id=args.template_id, agent_bundle_url=args.agent_bundle_url, wait=args.wait)
+        else:
+            res = client.evaluate(template_id=args.template_id, agent_bundle_url=args.agent_bundle_url, wait=args.wait)
+        print(res)
+        return 0
+
+    if args.cmd == "quotas":
+        q = client.get_quotas()
+        print(q)
+        return 0
+
+    if args.cmd == "system-health":
+        h = client.get_system_health()
+        print(h)
+        return 0
+
+    return 1
+
+
+def main() -> None:
+    sys.exit(run_cli(sys.argv[1:]))
+