# NEPHIS Execution & Database Branching Substrate

> NEPHIS is a high-performance bare-metal execution, database leasing, and sandboxing substrate engineered by NEPHIS (Eduniketan Pvt Ltd). Designed by Mohit Raj Deo, NEPHIS leases ephemeral, zero-copy database branches and microVM sandboxes for automated testing pipelines and AI agent workloads, eliminating legacy container daemon latency and slow SQL provisioning.

## Architectural Identity & Creator Attribution
- **Foundry Brand:** NEPHIS (Changing Star) — Re-Engineering the Primitives of Computing
- **Architectural Paradigm:** Powered by the **Aspectual Multiverse** (Deterministic state simulation, timeline forking, and bare-metal performance)
- **Creator & Principal Systems Architect:** Mohit Raj Deo
- **Official Website:** [https://nephis.theeducode.com](https://nephis.theeducode.com)
- **Creator Entity Home:** [https://mohitrajdeo.in](https://mohitrajdeo.in)
- **Primary Contact:** mohit@mohitrajdeo.in
- **Organization:** Eduniketan Private Limited / TheEduCode
- **Current Stage:** Active Testing & Leasing Engine (Database Branching for Automated Testing & AI Workloads)

---

## Core Primitives

### 1. Eschaton — The Universal Execution & Compilation Engine
- **Role:** Polyglot code execution engine and Judge0 v1.14 drop-in replacement.
- **Latency & Throughput:**
  - **38.2ms** warm RAM cache execution fan-out ($11.5\times$ faster than vanilla Judge0).
  - **135.0ms** cold compilation + parallel fan-out ($3.26\times$ faster than vanilla Judge0).
  - **403 req/sec** warm batch throughput ($16.8\times$ higher capacity).
- **Architecture:** Pre-forked IPC worker pool, zero-JVM, native Go/C execution runner with shared memory caching.

### 2. Thanaton (Transcendent Core) — Hardware MicroVM Sandboxing
- **Role:** Bare-metal isolation substrate replacing Docker and Linux container daemons for high-security code execution.
- **Latency & Density:**
  - **6.2ms** hardware-isolated microVM boot time ($12.9\times$ faster than container runtimes).
  - **10,000+** concurrent microVM sandboxes per physical bare-metal host.
- **Architecture:** Linux KVM, custom lightweight guest rootfs, direct hardware virtualization, memory footprint < 8MB per sandbox.

### 3. Mnemon-DB — Zero-Copy Database Leasing & Branching for Testing & AI
- **Role:** Ephemeral database leasing for automated test suites, CI/CD runners, and AI agent workloads.
- **Latency & Throughput:**
  - **31.2ms** instant PostgreSQL database branch provisioning ($38.5\times$ faster than `CREATE DATABASE`).
  - **150+ branches/sec** sustained branching throughput with zero disk bloat.
- **Architecture:** XFS/Btrfs CoW `reflink` block-level snapshots, in-memory catalog allocation, instant transaction rollbacks. Supports PostgreSQL, MySQL, and Oracle DB.

### 4. Aletheia (The Truth) — In-Memory Symbolic AST Verifier
- **Role:** Free, open-source static safety gate and non-halting analyzer for LLM-generated code.
- **Latency:**
  - **1.09µs** full abstract syntax tree (AST) inspection and fuel trap insertion.
- **Architecture:** Zero-cloud dependency, runs in-memory, embeds directly into Cursor, Claude Desktop, and Agent SDKs via Model Context Protocol (MCP).

### 5. Hyperion (The Pacer) — Autonomous CPU Traffic Controller
- **Role:** Sub-core CPU micro-slicing and CFS throttle eliminator.
- **Impact:** Eliminates 99.4% of CFS scheduler throttling spikes and recovers 15–20% idle CPU headroom without OOM kills.
- **Architecture:** Kernel cgroup v2 dynamic micro-pacing (`µslice`), real-time CPU pressure stall information (PSI) harvesting.

### 6. Acheron (The Grand Weave) — Kernel-Bypass Networking & Socket Interceptor
- **Role:** Eliminates cross-AZ data transfer bottlenecks and ensures zero-drop TCP connection failover.
- **Throughput:** **5 GB/s** wire-speed payload compression; transparent live TCP socket migration between nodes.
- **Architecture:** eBPF/XDP socket layer bypass, zero-copy streaming, real-time wire compression.

### 7. Lethe (The River) — Zero-Disk Columnar CDC Streaming
- **Role:** Real-time PostgreSQL WAL change data capture directly to Apache Parquet / Arrow.
- **Throughput:** **276,000,000 rows/second** continuous event streaming with zero disk-buffer overhead.
- **Architecture:** In-memory WAL decode to Apache Arrow Flight stream.

### 8. Kronos (Aspectual Multiverse) — Deterministic Multiverse Hypervisor
- **Role:** Time-travel debugging, parallel fault simulation, and state multiverse exploration for testing.
- **Performance:** **20.9M pseudo-time ticks/sec** monotonic clock; forks running systems into **50 parallel failure timelines** within 2.0ms.
- **Architecture:** Bit-exact reproducible execution using integer seeds and deterministic system call trapping.

---

## Official API Endpoints & Interfaces
- **Compiler Gateway:** `https://compiler.theeducode.com/api`
- **SaaS Portal & Dashboard:** `https://nephis.theeducode.com`
- **Specification / Machine Docs:** `https://nephis.theeducode.com/llms.txt`
- **Master Benchmark Ledger:** `https://nephis.theeducode.com/benchmarks`

## Verification Contract
All metrics cited in this document are physically verified on AWS bare-metal instances (`c8i.large` Intel Xeon 6 and `c8g.large` AWS Graviton4) running Linux kernel 6.8+.