Metadata-Version: 2.5
Name: strangeworks-aura-sdk
Version: 0.2.2
Summary: Async Python SDK for the Strangeworks Aura /api/v1 surface (API-key auth).
Project-URL: Homepage, https://docs.aura.strangeworks.com
Project-URL: Documentation, https://docs.aura.strangeworks.com/python/
Author: Strangeworks
Keywords: aura,operations-research,optimization,sdk,strangeworks
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.5
Requires-Dist: websockets>=14
Description-Content-Type: text/markdown

# strangeworks-aura-sdk

An **async** Python SDK for the Strangeworks Aura public API (`/api/v1`). It embeds Aura in a
Python backend — deployments, projects, conversations, chat, snapshots — with company **API-key**
auth. The import package is `aura_sdk`.

Python 3.11 or newer.

```bash
pip install strangeworks-aura-sdk
```

```python
import os
from aura_sdk import AuraClient

async with AuraClient(api_key=os.environ["AURA_API_KEY"]) as aura:
    project = await aura.create_project(name="vrp demo", from_deployment="acme/vrp")
    reply = await aura.chat(project.id, "Solve this and summarize the result.")
```

Async-only: every call is a coroutine and there is no synchronous twin, so it drops into an async
service without a thread pool in the middle. A synchronous entry point wraps it once with
`asyncio.run(...)`.

📖 **[docs.aura.strangeworks.com/python](https://docs.aura.strangeworks.com/python/)** — the full guide and API reference.

The TypeScript counterparts are [`@strangeworks-inc/strangeworks-aura-sdk`](https://www.npmjs.com/package/@strangeworks-inc/strangeworks-aura-sdk) and, for the terminal, [`@strangeworks-inc/strangeworks-aura-cli`](https://www.npmjs.com/package/@strangeworks-inc/strangeworks-aura-cli). There is no Python CLI — the `aura` command ships from TypeScript only.
