Metadata-Version: 2.4
Name: nees-core-sdk
Version: 0.1.0
Summary: Python client for the NEES API.
Author: Nainacore Emotional Tech
License-Expression: LicenseRef-Nainacore-SDK-Proprietary
Project-URL: Homepage, https://nees.cloud
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests<3,>=2.31
Dynamic: license-file

# NEES Python SDK

The NEES Python SDK is the official Python client for connecting applications to NEES governed AI runtime services.
SDK v0.1 currently exposes only the authenticated chat capability.

## Install

```bash
pip install nees-core-sdk
```

The PyPI distribution is `nees-core-sdk`; the Python import package is `nees`.

Python 3.9 or newer is required.

## Quickstart

Trial API keys are currently issued manually by Nainacore.

Windows PowerShell:

```powershell
$env:NEES_API_KEY="..."
```

Linux/macOS:

```bash
export NEES_API_KEY="..."
```

```python
from nees import NEESClient

client = NEESClient()
result = client.chat("Reply with exactly: NEES SDK connected")
print(result.reply)
```

To configure a different endpoint or timeout:

```python
client = NEESClient(api_key="...", base_url="https://api.nees.cloud", timeout=30)
```

The SDK requires HTTPS for remote endpoints. Plain HTTP is accepted only for localhost development.

The SDK currently supports only `chat:invoke`.

## Response boundary

The SDK exposes a deliberately limited public response model: reply/session identifiers,
request and trace identifiers, and selected public governance fields. Unrecognized API
response fields are not surfaced by the SDK.

## Errors

Catch `NEESAPIError` for all API failures, or a specific exported subclass such as
`NEESAuthenticationError`, `NEESAuthorizationError`, and `NEESRateLimitError`.

## License

The SDK is distributed under the Nainacore SDK Proprietary License included with this package.
This license applies to the SDK only and does not grant rights in the NEES Core Engine or
other service-side technology.
