Skip to main content

⚡ ZASI: Zero-Entropy Autonomous Superintelligence Infrastructure

Version PyPI Subsystems Tests Python React Discussions License

ZASI is an omniversal superintelligence operating system and cybernetic command architecture integrating 176 formal, physical, and cognitive subsystems with a real-time React 18 + React Router v6 J.A.R.V.I.S. Command Cockpit, WebSocket streaming, First-Order SMT invariant verification, and safe Recursive Self-Improvement (RSI).


🌌 System Architecture & Navigation

graph TD
    Client["Browser / Electron Desktop Client"]
    Router["React Router v6 SPA Shell"]
    Overview["Overview & 3D 176-Node Hypergraph (/)"]
    Jarvis["Multi-Persona Voice & Speech Chat (/jarvis)"]
    Subsystems["176-Subsystem Interactive Matrix (/subsystems)"]
    Cockpit["Quantum QEC & Physical FPGA Runner (/cockpit)"]
    MCP["JSON-RPC 2.0 Terminal & Protocol Tools (/mcp)"]
    
    Backend["Python Unified Backend (HTTP & RFC 6455 WebSocket)"]
    Engine["176-Subsystem Dialectical Pipeline & SMT Solver"]
    DB[("SQLite State Persistence: data/zasi_state.db")]
    Gemini["Google Gemini 2.0 Flash Grounding Bridge"]

    Client --> Router
    Router --> Overview
    Router --> Jarvis
    Router --> Subsystems
    Router --> Cockpit
    Router --> MCP

    Router <==>|"REST /api/* & WebSocket /ws"| Backend
    Backend <==> DB
    Backend <==> Engine
    Backend <==> Gemini

🚀 Quick Start

1. Automated Zero-Touch Installation

# Clone the repository
git clone https://github.com/cvsz/zasi.git
cd zasi

# Run automated builder, verification test runner, and installer
./install.sh

2. Launch the J.A.R.V.I.S. Command Cockpit

# Start the full-stack server on http://localhost:8080
make server

# Or via Docker
make docker-build && make docker-run

3. Run the 172-Test Suite

make test-all

📡 REST, WebSocket & MCP API Endpoints

Endpoint Method Protocol Description
/ GET HTTP React Router v6 SPA Web Cockpit
/ws GET WebSocket Real-time 2s telemetry & log stream (RFC 6455)
/api/status GET JSON System operational state, SMT invariants, active version
/api/telemetry GET JSON Host CPU, RAM, NVML GPU load, Arc Reactor power
/api/tick GET JSON Execute one autonomous cognitive cycle
/api/subsystems GET JSON Complete catalog of all 168 subsystems
/api/jarvis/chat POST JSON Multi-turn persona chat (J.A.R.V.I.S. / F.R.I.D.A.Y. / E.D.I.T.H.)
/api/jarvis/stream POST SSE Word-by-word streaming dialogue response
/api/mcp POST JSON-RPC 2.0 MCP protocol tool execution & resource inspection
/api/mutate POST JSON Hot-mutate cognitive state variables
/api/rsi/upgrade POST JSON Deploy verified recursive self-improvement runtime
/api/webhooks POST JSON Register external event webhook dispatchers
/api/openapi.json GET OpenAPI 3.0 Full interactive OpenAPI 3.0 specification

⚙️ Environment Variables

Variable Default Purpose
ZASI_PORT 8080 Server listening port
ZASI_API_KEY (empty) Optional API key authentication header (X-API-Key)
GEMINI_API_KEY (empty) Optional Google Gemini 2.0 Flash API key for neural grounding

📜 Documentation Reference


🛡️ License

MIT License. Copyright © 2026 ZASI Contributors.

Metadata

Release files for zasi 32.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zasi 32.0.0
File Size Uploaded
zasi-32.0.0.tar.gz 143.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for zasi 32.0.0
File Interpreter ABI Platform
zasi-32.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 326.8 kB

Release files / zasi-32.0.0.tar.gz

Download URL zasi-32.0.0.tar.gz
Size 143.4 kB
Tags Source
SHA-256 checksum
How to use checksums
a79d9013083aff3151ffd7c8489636f0b01485c61333f667b2c5e27d25ea0d09
BLAKE2b-256 checksum
How to use checksums
7975c1901609c07b1f1530561fd87ec04222c0b7d5263907e7045f1323ac4f7c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / zasi-32.0.0-py3-none-any.whl

Download URL zasi-32.0.0-py3-none-any.whl
Size 183.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6cb0b109b1d91a1000b5b2df16ac92519f6ffa1d098572f9edd5e9485737ca83
BLAKE2b-256 checksum
How to use checksums
2b55bb1c66dbe675260904990889851be41ddec2686b75ab03b4e4cd85a7e2bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

32.0.2

2 release files

This release

32.0.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page