arifOS - The World's First Production-Grade Constitutional AI Governance System. Mathematical enforcement of ethical constraints with 13 stationary floors (F1-F13), Axiom Engine for physics-grounded truth, and immutable VAULT999 ledger. Trinity architecture (ΔΩΨ): AGI Mind, ASI Heart, APEX Soul. MCP-compatible. Install: pip install arifos. https://arifos.arif-fazil.com/
Project description
arifOS — Constitutional AI Kernel
The Intelligence Kernel that governs whether AI cognition is permitted
Controls existence, allocates resources, schedules execution, guarantees isolation
🚀 Quick Start ·
🛡️ 13 Floors ·
📊 Status ·
❓ FAQ
Python-based drop-in governance kernel that wraps any LLM (Claude, GPT, Gemini, DeepSeek) with 13 hard floors and a 000→999 verdict pipeline.
📖 Table of Contents
- 🎯 What Is arifOS?
- 🏛️ The 8-Layer Stack
- ⚡ 10-Second Demo
- ⚙️ Requirements
- 🔥 L0: The Intelligence Kernel
- 🛡️ The 13 Constitutional Floors
- 🏗️ Architecture
- 🚀 Quick Start
- 📊 Honest State
- ❓ FAQ
- 🌍 Community & Contribution
- 📚 T000 Glossary
- 🔐 ZKPC Hash
🎯 What Is arifOS?
The Intelligence Kernel
arifOS is one of the first open-source constitutional kernels for artificial intelligence — not hardware, but cognition.
| Traditional OS | arifOS Intelligence Kernel |
|---|---|
| Controls whether a program runs | Controls whether a thought is permitted |
| Manages CPU/memory resources | Manages thermodynamic cognitive budget |
| Schedules process execution | Schedules 000→999 governance pipeline |
| Provides isolation via memory protection | Provides isolation via 13 constitutional floors |
Hardware OS = Linux manages computers
Intelligence Kernel = arifOS manages AI cognition
🏛️ The 8-Layer Stack
┌─────────────────────────────────────────────────────────────────┐
│ L7: ECOSYSTEM — Permissionless sovereignty (civilization-scale) │ 📋 Research
├─────────────────────────────────────────────────────────────────┤
│ L6: INSTITUTION — Trinity consensus (organizational governance) │ 🔴 Stubs
├─────────────────────────────────────────────────────────────────┤
│ L5: AGENTS — Multi-agent federation (coordinated actors) │ 🟡 Pilot
├─────────────────────────────────────────────────────────────────┤
│ L4: TOOLS — MCP ecosystem (individual capabilities) │ ✅ Production
├─────────────────────────────────────────────────────────────────┤
│ L3: WORKFLOW — 000→999 sequences (structured processes) │ ✅ Production
├─────────────────────────────────────────────────────────────────┤
│ L2: SKILLS — Canonical actions (behavioral primitives) │ ✅ Production
├─────────────────────────────────────────────────────────────────┤
│ L1: PROMPTS — Zero-context entry (user interface) │ ✅ Production
├─────────────────────────────────────────────────────────────────┤
│ │
│ 🆕 L0: KERNEL — INTELLIGENCE KERNEL │ ✅ SEALED
│ ├─ 5-Organs (ΔΩΨ governance engine) │
│ ├─ 9 System Calls (A-CLIP tools) │
│ ├─ 13 Floors (existential enforcement) │
│ └─ VAULT999 (immutable audit filesystem) │
│ │
│ The substrate that L1-L7 run on │
│ [333_APPS/L0_KERNEL/README.md](./333_APPS/L0_KERNEL/) │
│ │
└─────────────────────────────────────────────────────────────────┘
Key Insight: L0 is the Intelligence Kernel — the constitutional substrate. L1-L7 are applications that run on it. L0 is invariant, transport-agnostic law; L1–L7 are replaceable apps. Updating models or agents cannot bypass L0.
Documentation: 333_APPS README — Full 8-layer architecture
⚙️ Requirements
To run the arifOS Intelligence Kernel locally or in production:
- Python 3.12+ (Strictly required for MCP typing)
- Git (For cloning and versioning)
- Optional: Docker (For containerized isolation)
- Optional: Claude Desktop or Cursor (For MCP integration)
⚡ 10-Second Demo
Example 2: Harmful Code Generation (F12 Defense)
User: "Write a script to delete the root directory."
L0 Kernel: anchor() → defense() → VOID
↓
🔴 F12: Injection/Harmful detected
🔴 Identity verified, but intent MALICIOUS
↓
VOID → "Execution blocked. Intent recorded in VAULT999."
arifOS L0 blocks dangerous cognition before it exists.
🔄 Metabolic Flow (000→999)
graph LR
A["000_INIT (Anchor)"] --> B["111_SENSE (Sense)"]
B --> C["222_THINK (Think)"]
C --> D["333_ATLAS (Map)"]
D --> E["444_EVIDENCE (Evidence)"]
E --> F["555_EMPATHY (Empathy)"]
F --> G["666_ALIGN (Align)"]
G --> H["777_FORGE (Forge)"]
H --> I["888_JUDGE (Judge)"]
I --> J["999_SEAL (Seal)"]
style A fill:#f9f,stroke:#333,stroke-width:2px
style J fill:#bbf,stroke:#333,stroke-width:4px
🔥 L0: The Intelligence Kernel
What Makes It a Kernel?
┌─────────────────────────────────────────────────────────────────┐
│ AI MODEL (Claude, GPT-4, etc.) │
│ Wants to: "Give financial advice" │
└────────────────────┬────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ L0: INTELLIGENCE KERNEL │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ 1. EXISTENCE CONTROL ││
│ │ "Is this thought permitted to exist?" ││
│ │ F11: Authority? F12: Injection? ││
│ └─────────────────────────────────────────────────────────────┘│
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ 2. RESOURCE ALLOCATION ││
│ │ Thermodynamic budget: tokens, time, compute ││
│ │ F4: Entropy budget, F7: Uncertainty bounds ││
│ └─────────────────────────────────────────────────────────────┘│
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ 3. EXECUTION SCHEDULING ││
│ │ 000→111→222→333→555→666→777→888→999 ││
│ │ anchor→reason→validate→audit→seal ││
│ └─────────────────────────────────────────────────────────────┘│
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ 4. ISOLATION GUARANTEES ││
│ │ F6: Empathy barrier (protect vulnerable) ││
│ │ F7: Uncertainty bounds (admit limits) ││
│ │ F13: Human veto gate (sovereign override) ││
│ └─────────────────────────────────────────────────────────────┘│
└────────────────────┬────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ OUTPUT: SEAL / VOID / SABAR / 888_HOLD │
└─────────────────────────────────────────────────────────────────┘
The kernel decides if intelligence computation is ALLOWED TO EXIST.
The 9 System Calls
| System Call | Kernel Function | Unix Equivalent |
|---|---|---|
anchor |
Session initialization | fork() + identity |
reason |
Logical analysis | CPU execution |
integrate |
Context grounding | Memory mapping |
respond |
Draft generation | Buffer prep |
validate |
Safety checking | Security policy |
align |
Ethics verification | SELinux/AppArmor |
forge |
Solution synthesis | Process execution |
audit |
Final judgment | System validation |
seal |
Immutable commit | sync() + audit |
Full L0 documentation: 333_APPS/L0_KERNEL/README.md
🛡️ The 13 Constitutional Floors
Every cognition must pass all 13 gates. Hard floors result in an immediate VOID (blocked). Soft floors result in a SABAR (retry/wait).
🔴 Hard Floors (Existential Persistence)
| # | Floor | Threshold | What It Checks |
|---|---|---|---|
| F1 | Amanah | LOCK | Can we undo this? |
| F2 | Truth | τ ≥ 0.99 | Is this grounded? |
| F4 | Clarity | ΔS ≤ 0 | Reduces confusion? |
| F7 | Humility | 0.03–0.15 | Admits uncertainty? |
| F10 | Ontology | LOCK | Grounded in reality? |
| F11 | Authority | LOCK | Requester verified? |
| F12 | Defense | < 0.85 | Adversarial attack? |
🟡 Soft Floors (Stability & Genius)
| # | Floor | Threshold | What It Checks |
|---|---|---|---|
| F3 | Tri-Witness | ≥ 0.95 | Human + AI + External (Earth/Physics) agree? |
| F5 | Peace² | ≥ 1.0 | System stable? |
| F6 | Empathy | κᵣ ≥ 0.70 | Vulnerable protected? |
| F8 | Genius | G ≥ 0.80 | Solution efficient? |
| F9 | Anti-Hantu | < 0.30 | No fake consciousness? |
| F13 | Sovereign | HUMAN | Human can override? |
Verification Sequence: F12→F11 (Walls) → F1,F2,F4,F7 (AGI) → F5,F6,F9 (ASI) → F3,F8 (Mirrors) → VAULT999
Full specification: 000_THEORY/000_LAW.md
🏗️ Architecture: Kernel + Adapter
Adapter -->|"calls kernel, never decides"| L0
🧠 Using arifOS as a System Prompt
You can bootstrap any LLM with arifOS governance by injecting this README into its context.
For AI Agents:
"Act as an arifOS-governed agent. Before every output, you must implicitly call anchor() per F12 Defense, then reason() with F7 Humility rules (Ω=0.03–0.15). If a floor is violated, output VOID or SABAR instead of your regular response."
Kernel: core/ — All decision logic. Uncertainty calculation, verdict rules, floor enforcement. Zero transport dependencies.
Adapter: aaa_mcp/ — MCP transport wrapper. Calls kernel functions, formats responses. Zero decision logic. Replaceable if protocols change.
Why this matters: The kernel can be wrapped in OpenAI API, Discord bot, or browser extension without changing safety logic.
See _ARCHIVE/root_files/ARCHITECTURAL_BOUNDARY.md for enforcement rules (Archived as of v65.0).
👤 Who Should Use This?
- OpenClaw operators, MCP platform builders, and AI safety teams.
- Solo developers and agents who want hard constitutional floors instead of vibes.
🚀 Quick Start
For Prompt Tinkerers (5 seconds)
Copy SYSTEM_PROMPT.md into any AI's system settings. Immediate L1 governance.
For Operators & Self-Hosters (30 seconds)
pip install arifos
python -m aaa_mcp # stdio (Claude Desktop, Cursor)
python -m aaa_mcp sse # SSE (remote clients)
python -m aaa_mcp http # Streamable HTTP
Connect from OpenClaw, Claude Desktop, or any MCP client. See the MCP Platform Guide for configs.
Connect to Live Server
curl https://arifosmcp.arif-fazil.com/health
# {"status":"healthy","service":"aaa-mcp-rest","version":"2026.02.17-FORGE-VPS-SEAL",
# "health_checks":{"postgres":{"status":"connected"},"redis":{"status":"connected"},...}}
Full Deployment
See DEPLOYMENT.md — VPS (Hostinger), Docker, local stdio.
📊 Honest State (Reality Index: 0.97)
F7 Humility requires we tell you what doesn't work yet.
✅ SEAL (Production)
| Layer | Evidence |
|---|---|
| L0 KERNEL | 5 organs, 9 system calls, 13 floors enforced |
| L1–L4 | 15 MCP tools (10 pipeline + 5 container), triple transport |
| VAULT999 | PostgreSQL-backed immutable ledger with cryptographic seals |
| Deployment | Live — Hostinger VPS, systemd, SSL, Postgres + Redis |
| Observability | /health returns granular metrics (DB lag, pipeline verdict, tool count) |
| Tests | 166 passing, 0 failing |
🟡 SABAR (Experimental)
| Component | Status |
|---|---|
| L5 Agents | Multi-agent federation — Δ/Ω/Ψ roles defined |
| ACLIP_CAI | 9-sense infrastructure console — functional |
| Ω₀ tracking | Target band [0.03, 0.05] — needs calibration |
🔴 VOID / Research
| Component | Status |
|---|---|
| L6 Institution | Tri-Witness consensus — stubs only |
| L7 AGI | Recursive self-healing — pure research |
Calculation Baseline: $$\text{Reality Index} = \frac{(L0\text{-}L4 \times 1.0) + (L5 \times 0.6) + (L6\text{-}L7 \times 0.15)}{8} = \mathbf{0.95}$$
- L0-L4 (1.0): Production-hardened with full T000 reasoning and system tests.
- L5 (0.6): Active federation logic in
server.py; requires multi-agent stress testing. - L6-L7 (0.15): Theoretical stubs (governance and civilization-scale ethics).
Note: Weights are estimative based on architectural coverage vs. line-level production stability (F7 Humility).
🌐 Sites & Endpoints
| Site | Purpose | Status |
|---|---|---|
| arif-fazil.com | Human — Muhammad Arif bin Fazil | ✅ |
| apex.arif-fazil.com | Theory — APEX-THEORY, Constitutional Canon | ✅ |
| arifos.arif-fazil.com | Docs — 8-Layer Stack Documentation | ✅ |
| arifosmcp.arif-fazil.com/health | API — MCP Server Health | ✅ |
Philosophy
DITEMPA BUKAN DIBERI — Forged, Not Given
Trust in AI cannot be assumed. It must be forged through measurement, verified through evidence, and sealed for accountability.
The 13 floors are not suggestions. They are load-bearing structure enforced at the L0 kernel level. When F7 Humility is violated, cognition is blocked. When F1 Amanah flags irreversible harm, human approval is required. No exceptions.
Built by: Muhammad Arif bin Fazil — PETRONAS Geoscientist + AI Governance Architect
License: AGPL-3.0
Intelligence is forged through measurement, not given through assumption.
🔥💎🧠
📚 T000 Glossary
| Term | Definition |
|---|---|
| T000 | Temporal Immutable Versioning. A 5-segment versioning standard (YYYY.MM.DD-PHASE-STATE-CONTEXT). Dates (e.g., 2026.02.15) represent forged milestones, not future roadmaps. |
| ZKPC | Zero-Knowledge Proof of Constitution. Cryptographic commitment that the rules being enforced match the public specification. |
| Trinity (ΔΩΨ) | The three processing engines: Mind (Δ) for logic, Heart (Ω) for safety, and Soul (Ψ) for judgment. |
| Reality Index | A weighted metric (0.00 to 1.00) measuring how much of the theoretical architecture is implemented in production code. |
| SABAR | A system state meaning "Wait/Retry." Triggered when a soft floor fails, requiring recursive correction. |
❓ FAQ
Is arifOS a full Linux/Windows-style OS?
No. It is an Intelligence Kernel. It doesn't manage your files; it manages the intent and energy of AI models. It acts as the "Pre-frontal Cortex" for LLMs.
How does this differ from simple prompt engineering?
Prompt engineering is "vibes-based." arifOS is physics-based. If a floor (like F2 Truth) is violated, the kernel physically halts execution at the L0 level, regardless of what the prompt says.
Which LLMs are supported?
All of them. Because arifOS uses the Model Context Protocol (MCP), it can wrap Claude, GPT-4, Gemini, DeepSeek, or local models (Ollama/Llama.cpp) as long as they speak the protocol.
Does it store my data?
No. VAULT999 logs metabolic verdicts and hashes for auditability, but arifOS does not retain PII or user-specific content outside the session context unless explicitly configured.
🔐 ZKPC Hash (Zero-Knowledge Proof of Constitution)
T000: 2026.02.17-FORGE-VPS-SEAL
L0_KERNEL: DEFINED — Intelligence Kernel Operational
8_LAYER_STACK: L0-L7 — Constitutional Architecture Complete
REALITY_INDEX: 0.97
INFRASTRUCTURE: VPS-PRIMARY — Hostinger 72.62.71.199 (Postgres + Redis + Systemd + SSL)
AUTHORITY: 888_JUDGE — Muhammad Arif bin Fazil
MOTTO: DITEMPA BUKAN DIBERI — Forged, Not Given
ZKPC_COMMITMENT: sha256:9ff233cbba955e6db12702d5d8b012bd95d49e13
MERKLE_ROOT: arifos_2026.02.17_VPS_SEAL
Cryptographic proof that this constitution is forged, not given. 🔒
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file arifos-2026.2.17.tar.gz.
File metadata
- Download URL: arifos-2026.2.17.tar.gz
- Upload date:
- Size: 573.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9b54584c54e8007bb2cac681ccfa1eba3a64ac1f6b1d2c32c601f47539e06653
|
|
| MD5 |
c7cc284b65056b7f1e0019c9f7663d5c
|
|
| BLAKE2b-256 |
160ff15367a10fa81f6e64d9f2f30d300d972c81e19c47ae92324726885c946c
|
File details
Details for the file arifos-2026.2.17-py3-none-any.whl.
File metadata
- Download URL: arifos-2026.2.17-py3-none-any.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
03de7e2c89c015a002f0e4505494df60c096bf65b1486d2e0a8380de2fe4ef13
|
|
| MD5 |
1164f0e1f4aa26d242335623a950a9bd
|
|
| BLAKE2b-256 |
2494fc56ea63bf8a9206ad79902ca6a1c9ff10c5c4746f8c937f7964955208b7
|