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

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:

$env:NEES_API_KEY="..."

Linux/macOS:

export NEES_API_KEY="..."

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:

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.