Metadata-Version: 2.4
Name: pinuxd
Version: 0.1.0
Summary: Pinuxd — the intellective layer: an operating system for enterprise AI (knowledge graph, governed workflows, cost governor, provable multi-tenant isolation).
Author-email: Mohit Deepak Soni <mohitdeepaksoni@gmail.com>
Maintainer-email: Mohit Deepak Soni <mohitdeepaksoni@gmail.com>
License: Proprietary
Keywords: knowledge-graph,graphrag,semantic-layer,enterprise-ai,governed-ai,agents,workflow-engine,rag,multi-tenant,cost-optimization
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
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 :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: antahkarana>=8.0.0
Provides-Extra: kuzu
Requires-Dist: kuzu>=0.4; extra == "kuzu"
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"

# Pinuxd

**The intellective layer — an operating system for enterprise AI.**

Pinuxd is the backbone that decides *how* an organization uses AI across its data, documents, events,
models, and compute — grounded in a knowledge graph, governed end to end, and continuously optimized for
**accuracy ↑, speed ↑, cost ↓**.

Not a chatbot, not a framework, not a model. An **operating system**: it owns the scheduling, memory,
security, I/O, and processes for AI the way a kernel owns them for a computer — so you build *on* it instead
of re-wiring an agent framework + a vector database + a rules engine + a governance bolt-on for the tenth
time.

> **Commercial software — free for 90 days.** After the trial a license key is required.
> For a license key, contact **mohitdeepaksoni@gmail.com**.

---

## Install

```bash
pip install pinuxd
```

## What you get

| Plane | Capability |
|---|---|
| **Knowledge graph & semantic layer** | A property graph, a business glossary/ontology, entity resolution, and **GraphRAG** — grounded, multi-hop, cited retrieval that connects facts flat top-k retrieval cannot. |
| **Data & document fabric** | Connectors, multi-modal ingestion (text/table/image/audio), incremental ETL into the graph with provenance and provable freshness. |
| **Cost governor** | A semantic cache, a reranker, and cheap-first **learned-and-gated** routing that serves the cheapest path clearing an accuracy bar — with the accuracy floor enforced at execution. |
| **Workflow & event engine** | Durable, resumable, event-driven workflows with human-in-the-loop, saga compensation, SLAs, and exactly-once across a crash/failover. |
| **Policy & rules engine** | RBAC, rules-as-constraints, living-policy binding, and a **machine-checked proof of zero rule violations**. |
| **Enterprise hardening** | **Provable multi-tenant isolation**, observability, quotas, deploy/DR, air-gap, and an admin console. |

## Quickstart

```python
from pinuxd import InMemoryGraphBackend, EntityResolver, GraphRAG

g = InMemoryGraphBackend()
r = EntityResolver(g)
t = r.resolve_or_create("T-12", "ticket")
a = r.resolve_or_create("Alice", "engineer")
b = r.resolve_or_create("Bob", "manager")
g.add_edge(t, "fixed_by", a)
g.add_edge(a, "reports_to", b)

# GraphRAG answers a 2-hop question flat retrieval cannot reach
ctx = GraphRAG(g, resolver=r, k_hops=2).retrieve("who manages the engineer who fixed T-12?")
print(ctx.to_text())
```

Route requests for cost while holding an accuracy bar:

```python
from pinuxd import CostGovernor, Tier

gov = CostGovernor(
    tiers=[Tier("skill", 0, handler=skill_fn), Tier("small", 1, handler=small_llm),
           Tier("large", 8, handler=large_llm)],
    scorer=accuracy_fn, accuracy_bar=0.7)
gov.ask("summarize this ticket")
print(gov.report().savings)     # cheapest path that clears the bar; savings vs all-strongest
```

Prove your guarantees:

```python
from pinuxd import check_policy, check_isolation
assert check_policy().ok        # zero rule violations over the full state space (machine-checked)
assert check_isolation().ok     # no cross-tenant access over the full state space (machine-checked)
```

## Design principles

- **Governed by construction** — every data/model/tool call flows through a non-bypassable control plane and
  is audited; the guarantees that matter are **machine-checked**, not asserted.
- **Parallel-first** — expensive work runs concurrently; only critical mutations are serialized.
- **Highly available** — replicated, quorum-based journal and vector storage; survives a node down; self-heals.
- **CPU or GPU** — the same code runs on CPU, NVIDIA (CUDA), or AMD (ROCm).
- **Vendor-neutral** — any model, any vector store, any knowledge-graph engine, via clean seams.

## Licensing

Commercial software with a **90-day free trial**, then a signed license key (Ed25519; verified offline).
The customer CLI ships with the package:

```bash
pinuxd-license status               # trial/license status
pinuxd-license install "<KEY>"      # install a purchased key
```

Enforce it at start-up:

```python
from pinuxd.licensing import LicenseManager
LicenseManager().require()          # raises when a key is required, with the contact address
```

**For a license key or commercial enquiries: mohitdeepaksoni@gmail.com**

---

© Mohit Deepak Soni. All rights reserved. Proprietary — see the licensing terms.
