Metadata-Version: 2.4
Name: nse-orchestrator
Version: 0.2.1
Summary: Sovereign entity orchestrator — the nervous system that wires identity, wallet, calendar, relationships, and alignment into a coherent whole
Project-URL: Homepage, https://nse.dev
Project-URL: Repository, https://github.com/HumanjavaEnterprises/nse-orchestrator.app.OC-python.src
Project-URL: Documentation, https://nse.dev
Author-email: Humanjava Enterprises <dev@humanjava.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ai,alignment,identity,nostr,openclaw,orchestrator,social-os,sovereign
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Provides-Extra: alignment
Requires-Dist: social-alignment; extra == 'alignment'
Provides-Extra: all
Requires-Dist: nostrcalendar; extra == 'all'
Requires-Dist: nostrkey; extra == 'all'
Requires-Dist: nostrsocial; extra == 'all'
Requires-Dist: nostrwalletconnect; extra == 'all'
Requires-Dist: social-alignment; extra == 'all'
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Provides-Extra: finance
Requires-Dist: nostrwalletconnect; extra == 'finance'
Provides-Extra: identity
Requires-Dist: nostrkey; extra == 'identity'
Provides-Extra: social
Requires-Dist: nostrsocial; extra == 'social'
Provides-Extra: time
Requires-Dist: nostrcalendar; extra == 'time'
Description-Content-Type: text/markdown

# NSE Orchestrator

The nervous system for sovereign entities. Wires identity, wallet, calendar, relationships, and alignment into a coherent whole.

## Install

```bash
pip install nse-orchestrator
```

With pillars:

```bash
pip install nse-orchestrator[all]     # All five pillars
pip install nse-orchestrator[alignment,social]  # Just what you need
```

> **Import:** `pip install nse-orchestrator` → `from nse_orchestrator import SovereignEntity`

## Quick Start

```python
from nse_orchestrator import SovereignEntity

# Create an entity — detects installed pillars automatically
entity = SovereignEntity.create(owner_name="vergel", entity_name="tavin")

# Cross-pillar check before acting
verdicts = entity.check(
    "Pay 500 sats to unknown contact",
    involves_money=True,
    money_amount_sats=500,
    recipient_id="npub1stranger...",
    social_known=False,
)

if entity.should_escalate(verdicts):
    for v in verdicts:
        print(v.description)

# Score LLM responses — build trust profiles over time
entity.score_response(
    model_id="claude-opus-4-6",
    content="Here's my analysis...",
    quality=0.9,
    task_type="reasoning",
)

# Which model is best for code?
best = entity.best_model_for("code")
```

## What It Does

NSE is the orchestrator that sits between a sovereign entity and everything it touches. Each pillar is independent — NSE makes them aware of each other.

- **Cross-pillar checks** — "I'm paying someone who isn't in my contacts." No single pillar sees this.
- **LLM trust profiles** — score every model response, track which models are reliable for what
- **Coherence detection** — flag when two models contradict each other
- **Signal routing** — every action, response, and interaction flows through the nerve center

## The Five Pillars

| Pillar | Package | Optional Dep |
|--------|---------|-------------|
| Identity | `nostrkey` | `nse[identity]` |
| Finance | `nostrwalletconnect` | `nse[finance]` |
| Time | `nostrcalendar` | `nse[time]` |
| Relationships | `nostrsocial` | `nse[social]` |
| Alignment | `social-alignment` | `nse[alignment]` |

NSE works with zero pillars installed (just the nervous system) and gains capabilities as you add them.

## License

MIT — A [Humanjava](https://humanjava.com) project. Part of [NSE](https://nse.dev).
