Metadata-Version: 2.4
Name: nexus-ai-os-sdk
Version: 0.1.0
Summary: Python SDK for NEXUS AI OS — build apps against your local NEXUS instance.
Author: Anthony Miles
License: MIT
Project-URL: Homepage, https://github.com/anthonymiles1/nexus-ai-os
Project-URL: Repository, https://github.com/anthonymiles1/nexus-ai-os
Project-URL: Issues, https://github.com/anthonymiles1/nexus-ai-os/issues
Project-URL: Documentation, https://github.com/anthonymiles1/nexus-ai-os/tree/main/packages/sdk/python
Keywords: nexus,ai,llm,local-first,sdk,client
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: twine>=4.0; extra == "dev"

# nexus-ai-os-sdk

Python SDK for [NEXUS AI OS](https://github.com/anthonymiles1/nexus-ai-os). Build apps against your local NEXUS instance with a typed, async-friendly client.

## Install

```bash
pip install nexus-ai-os-sdk
```

## Quick start

```python
import asyncio
from nexus_ai_sdk import NexusClient

async def main():
    async with NexusClient("http://localhost:3000", api_key="your-key") as nexus:
        response = await nexus.chat("Hello!")
        print(response["content"])

asyncio.run(main())
```

## Requirements

- Python 3.10+
- `httpx >= 0.27`
- A running NEXUS gateway (default: `http://localhost:3000`)

## Publish

The package ships from `packages/sdk/python/`:

```bash
cd packages/sdk/python
python -m pip install -e ".[dev]"
python -m build
python -m twine upload dist/*
```

CI publishing happens via `.github/workflows/publish-sdk.yml` when a maintainer dispatches the workflow with a version bump.
