Metadata-Version: 2.4
Name: nex-sovereign-sdk
Version: 0.1.0
Summary: Python SDK for Nex Sovereign — Cognitive OS with 18-emotion HEART Engine
Project-URL: Homepage, https://github.com/manvendramodgilai-lang/NEX-AI-OS
Project-URL: Documentation, https://nexsovereign.com/developers
Project-URL: Repository, https://github.com/manvendramodgilai-lang/NEX-AI-OS
Project-URL: Issues, https://github.com/manvendramodgilai-lang/NEX-AI-OS/issues
Author-email: Manvendra Modgil <hello@nexsovereign.com>
License: MIT
License-File: LICENSE
Keywords: AI,HEART,cognitive-AI,cognitive-OS,emotional-intelligence,nex
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# Nex Sovereign SDK — Python

The official Python SDK for [Nex Sovereign](https://nexsovereign.com) — a cognitive AI operating system with an 18-emotion HEART Engine, persistent memory graph, PDAR reasoning, and boardroom governance.

## Install

```bash
pip install nex-sovereign-sdk
```

## Quick Start

```python
from nex_sdk import NexClient

nex = NexClient(api_key="nex_sk_...")

# Classify emotional content via HEART Engine
result = nex.heart.classify("user_123", "I'm excited about this project!")
print(result.classified.label)   # "happiness"
print(result.emotion_vector)     # full 18-dim vector
```

## Features

- **HEART Engine** — 18-dimensional emotion classification, injection, history, and pattern analysis
- **Memory Graph** — Persistent semantic memory with emotionally-biased retrieval
- **PDAR Reasoning** — Transparent Perceive-Decide-Act-Reflect reasoning traces
- **Boardroom** — Governance mandates for high-stakes AI actions

## Documentation

Full API reference and guides: [nexsovereign.com/developers](https://nexsovereign.com/developers)

## License

MIT
