NSE Orchestrator

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

Install

pip install nse-orchestrator

With pillars:

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

v0.2.3 — part of the coordinated 2026-07 correctness release (staged, pending PyPI publish). The whole Nostr library family was audited together and every package is now verified against a shared spine of known-answer test vectors (NIP-44 v2, NIP-49, NIP-19 TLV, BIP-340) so encode/decode bugs can't hide inside self-round-trip tests. This release enforces secret redaction on every signal-ingestion path (not just score_response), so nsec/API keys never reach disk. See CHANGELOG.md.

Quick Start

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

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

License

MIT — A Humanjava project. Part of NSE.