Metadata-Version: 2.4
Name: nees-gp-sdk
Version: 0.1.0
Summary: Python SDK for NEES GP — AI Governance Operating System
Home-page: https://github.com/NEES-Anna
Author: Nainacore Emotional Tech
Author-email: anna@nainacore.com
Project-URL: Documentation, https://nees-gp.onrender.com/docs
Project-URL: Source, https://github.com/NEES-Anna/NEES_GP_SDK
Project-URL: Tracker, https://github.com/NEES-Anna/NEES_GP_SDK/issues
Keywords: ai governance llm safety nees naina
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: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-mock>=3.10; extra == "dev"
Requires-Dist: responses>=0.23; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# NEES GP SDK

> AI Governance Operating System (AGOS) — control AI behavior across sessions, not just outputs.

---

## 🚀 What is NEES GP?

NEES GP is an **AI Governance Operating System** that manages AI behavior across time.

Unlike traditional AI safety tools that filter single outputs, NEES GP introduces:

* 🧠 **Intent-aware reasoning**
* 🔁 **Session-level governance**
* 🛡️ **Policy enforcement before generation**
* 📊 **Structured response metadata**

---

## 📦 Installation

```bash
pip install nees-gp-sdk
```

---

## ⚡ Quickstart (3 lines)

```python
from nees_gp_sdk import Client

client = Client(api_key="your-api-key")

res = client.chat("Mujhe kuch samajh nahi aa raha life mein")

print(res.text)
```

---

## 🧠 Response Structure

Every response includes both **AI output + governance metadata**:

```python
print(res.text)               # AI response
print(res.intent)             # e.g. "confusion"
print(res.framework)          # e.g. "confusion_direction"
print(res.urgency)            # "low" | "medium" | "high"
print(res.governance_clean)   # True / False
```

---

## 🎯 Why NEES GP?

Traditional AI:

* Input → Output filter

NEES GP:

* Input → Policy → Governance → Response → Session continuity

👉 This enables **stateful AI control across conversations**

---

## 🔧 Configuration

```python
client = Client(
    api_key="your-api-key",
    base_url="https://nees-gp.onrender.com",
    timeout=30
)
```

---

## ⚠️ Error Handling

```python
from nees_gp_sdk.exceptions import NEESError

try:
    res = client.chat("Hello")
except NEESError as e:
    print("Error:", str(e))
```

---

## 🛡️ Security & Privacy

* API keys are never stored in the SDK
* No local data persistence beyond session context
* Governance decisions happen server-side

---

## 🧪 Example Use Cases

* AI copilots with behavioral control
* Emotion-aware assistants
* Enterprise AI governance layer
* Multi-agent coordination systems

---

## 🌐 Vision

NEES GP defines a new category:

> **AI Governance Operating System (AGOS)**

A system that governs AI behavior across time, not just at the point of output.

---

## 🤝 Contributing

Contributions, feedback, and ideas are welcome.

---

## 📄 License

MIT License

---

## 👤 Author

Built by Nainacore Emotional Tech
Founder: Piyush P. Jambhulkar - ANNA
