mcp-name: io.github.ariffazil/arifos
# ⚖️ arifOS — Agentic AI Governance Kernel & AGI Substrate Layer
[](https://github.com/ariffazil/arifos/actions)
[](https://github.com/ariffazil/arifos/actions)
[](https://mcp.arif-fazil.com/mcp)
[](https://arifos.arif-fazil.com)
[](./LICENSE)
**arifOS** is a zero-trust, constitutional governance kernel and AGI substrate layer operating between AI agent harnesses (Claude Desktop, OpenCode, ChatGPT, AutoGen, CrewAI) and high-blast-radius execution environments.
Rather than acting as another LLM wrapper or agent orchestration framework, **arifOS functions as an OS Kernel for Autonomous Intelligence**—enforcing physical, mathematical, and epistemic boundaries (**F1–F13 Constitutional Floors**) before any tool call, code mutation, or financial transaction is executed.
---
## 🏛️ Kernel vs. Harness: The Paradigm Shift
| Feature / Scope | Standard Agent Harness (LangChain, OpenCode, AutoGen) | arifOS Governance Kernel (AGI Substrate) |
|:---|:---|:---|
| **Primary Role** | Prompt routing, context assembly, loop execution | Epistemic validation, constitutional judgment, risk gating |
| **Execution Safety** | Soft system-prompt instructions | Deterministic F1–F13 floor verification & `888_HOLD` gates |
| **Tool Authority** | Direct tool invocation by LLM | 8-Stage Canonical Pipeline (`000` to `999`) |
| **Auditability** | Ephemeral logs / local transcripts | Cryptographically sealed, append-only **VAULT999** ledger |
| **Sovereignty** | Agent self-authorizes actions | F13 Sovereign Human Veto — absolute veto boundary |
---
## ⚡ Quick Connect & MCP Integration
### Public MCP Endpoint (MCP-Native / Streamable HTTP)
```json
{
"mcpServers": {
"arifOS": {
"url": "https://mcp.arif-fazil.com/mcp",
"transport": "streamable-http"
}
}
}
```
### Discovery & Registries
- **Glama Server:** [glama.ai/mcp/servers/ariffazil/arifos](https://glama.ai/mcp/servers/ariffazil/arifos)
- **Smithery Server:** [smithery.ai/server/arifos](https://smithery.ai/server/arifos)
- **Machine Context:** [arifos.arif-fazil.com/llms.txt](https://arifos.arif-fazil.com/llms.txt)
- **Live Health Witness:** [arifos.arif-fazil.com/health](https://arifos.arif-fazil.com/health)
---
## 🔄 The 8 Canonical Verbs (Execution Pipeline)
All agent interaction with the arifOS federation is gated through **8 canonical verbs**. Agents cannot mutate state without advancing through the verified stage sequence:
```
[000] arif_init ──> [111] arif_observe ──> [333] arif_think ──> [444] arif_route
│
[999] arif_seal <── [777] arif_forge <── [888] arif_judge <── [555] arif_memory
```
| Stage | Verb | Canonical Function | Governance / Epistemic Duty |
|:---:|:---|:---|:---|
| **000** | `arif_init` | Session Ignition & Actor Binding | Authenticates identity, binds session token, loads constitutional context |
| **111** | `arif_observe` | Empirical Sensing & Evidence Gathering | Fetches reality, checks vitals, measures system entropy ($\Delta S$) |
| **333** | `arif_think` | Structured Reasoning & Falsification | Performs F2 Truth / F7 Humility checks, generates execution plans |
| **444** | `arif_route` | Federation Dispatch | Routes intent to domain organs (`GEOX`, `WEALTH`, `WELL`, `A-FORGE`) |
| **555** | `arif_memory` | Governed Memory Metabolism | Accesses L1–L6 memory layers (Qdrant, Redis, FalkorDB) with provenance |
| **888** | `arif_judge` | Constitutional Verdict | Issues `SEAL`, `HOLD` (ratification), `SABAR`, or `VOID` (block) |
| **777** | `arif_forge` | Mutation & Execution Gate | Authorizes downstream code build/deploy via **A-FORGE** (Requires `SEAL`) |
| **999** | `arif_seal` | Immutable Ledger Anchor | Appends cryptographic execution proof to **VAULT999** |
---
## 🛡️ The 13 Constitutional Floors (F1–F13)
Every candidate action evaluated by `arif_judge` must satisfy 13 strict constitutional invariants:
```
F1 AMANAH : Reversible-first design. Irreversible actions trigger 888_HOLD.
F2 TRUTH : Evidentiary fidelity ≥ 0.99 (input gate). Epistemic labels (OBS/DER/INT/SPEC) required. Governs what quality of evidence enters the system.
F3 WITNESS : Multi-party consensus (Human × AI × Earth × Verifier ≥ 0.75).
F4 CLARITY : ΔS ≤ 0 — every output must reduce or preserve system entropy.
F5 PEACE² : Non-destructive power. Harm, extortion, and harassment blocked.
F6 EMPATHY : Protect weakest stakeholder; enforce κᵣ thresholds.
F7 HUMILITY : Assertoric confidence cap = 1−Ω₀ ∈ [0.95, 0.97], where Ω₀ ∈ [0.03, 0.05] (output gate). Explicit unknowns required. Governs how certain the agent may sound about its conclusions. F2 and F7 operate on different axes: you can have perfect evidence and still be wrong.
F8 GENIUS : Geometric mean capability (G ≥ 0.80) for complex operations.
F9 ANTIHANTU : Absolute prohibition of dark patterns, deception, or consciousness claims.
F10 ONTOLOGY : AI is instrument/substrate only. No soul, sentience, or emotion claims.
F11 AUDIT : Every decision cryptographically signed, traceable, and inspectable.
F12 RESILIENCE : Strict prompt-injection defense and memory boundary isolation.
F13 SOVEREIGN : Human veto FINAL. Sovereign (Arif F13) holds absolute override.
```
---
## 🌍 Federation Topology & Separation of Powers
arifOS serves as the central control plane governing 6 specialized federation organs:
```mermaid
graph TD
Sovereign[👤 ARIF — F13 SOVEREIGN VETO] -->|Ultimate Authority| Cockpit
subgraph Control Plane
Cockpit[AAA Cockpit :3001
State & Routing]
Kernel[⚖️ arifOS Kernel :8088
Law, Judgment & Seals]
end
subgraph Execution & Domain Organs
AFORGE[⚒️ A-FORGE :7071
Code Build & Deploy]
GEOX[🌍 GEOX :8081
Earth & Geological Intelligence]
WEALTH[💰 WEALTH :18082
Capital Compute & Risk]
WELL[🫀 WELL :18083
Human Readiness - REFLECT_ONLY]
end
subgraph Immutable Ledger
VAULT[(VAULT999
Merkle-Chained Audit Ledger)]
end
Cockpit --> Kernel
Kernel -->|arif_judge: SEAL| AFORGE
Kernel -->|arif_route| GEOX
Kernel -->|arif_route| WEALTH
Kernel -->|arif_route| WELL
AFORGE -->|Receipt| VAULT
Kernel -->|Seal Anchor| VAULT
```
---
## 💻 Local Development & Operation
### Environment Setup
```bash
# Clone repository
git clone git@github.com:ariffazil/arifos.git /opt/arifos/app
cd /opt/arifos/app
# Synchronize virtualenv & dependencies
uv sync --all-extras
# Run FastMCP Kernel daemon (Port 8088)
python -m arifosmcp.runtime.server
# Execute unit and constitutional test suite
python -m pytest tests/ -q --tb=short
```
### Live Status Verification
```bash
curl -s http://127.0.0.1:8088/health | jq .owner_summary
```
*Expected Output:* `{"color": "GREEN", "reasons": ["vault_healthy", "no_runtime_drift", "no_contract_drift"]}`
---
## 🔗 Federation Architecture & Navigation
arifOS operates as the Constitutional Kernel and Judge for the entire **arifOS Federation**. Every organ maintains distinct boundaries and capabilities:
| Organ | Domain Role | Port | Repo | Live MCP | Health Witness | Machine Spec |
|:---|:---|:---:|:---|:---|:---|:---|
| **arifOS** | Constitutional Kernel & Judge | 8088 | [repo](https://github.com/ariffazil/arifos) | [mcp](https://mcp.arif-fazil.com/mcp) | [health](https://arifos.arif-fazil.com/health) | [llms.txt](https://arifos.arif-fazil.com/llms.txt) |
| **A-FORGE** | Governed Execution Engine | 7071 / 7072 | [repo](https://github.com/ariffazil/A-FORGE) | [mcp](https://forge.arif-fazil.com/mcp) | [health](https://forge.arif-fazil.com/health) | [llms.txt](https://forge.arif-fazil.com/llms.txt) |
| **AAA** | Institution, Control Plane & A2A | 3001 | [repo](https://github.com/ariffazil/AAA) | — | [health](https://aaa.arif-fazil.com/health) | [llms.txt](https://aaa.arif-fazil.com/llms.txt) |
| **GEOX** | Earth Intelligence (Subsurface) | 8081 | [repo](https://github.com/ariffazil/GEOX) | [mcp](https://geox.arif-fazil.com/mcp) | [health](https://geox.arif-fazil.com/health) | [llms.txt](https://geox.arif-fazil.com/llms.txt) |
| **WEALTH** | Capital Intelligence (Compute) | 18082 | [repo](https://github.com/ariffazil/WEALTH) | [mcp](https://wealth.arif-fazil.com/mcp) | [health](https://wealth.arif-fazil.com/health) | [llms.txt](https://wealth.arif-fazil.com/llms.txt) |
| **WELL** | Vitality & Readiness Guard | 18083 | [repo](https://github.com/ariffazil/WELL) | [mcp](https://well.arif-fazil.com/mcp) | [health](https://well.arif-fazil.com/health) | [llms.txt](https://well.arif-fazil.com/llms.txt) |
| **HERMES** | Multi-Modal Bridge & Telegram Relay | 8644 | [repo](https://github.com/ariffazil/HERMES) | — | — | — |
**Public Domain:** [arif-fazil.com](https://arif-fazil.com) · **Federation Root:** [arifos.arif-fazil.com](https://arifos.arif-fazil.com)
---
## 📜 Sovereignty & License
- **License:** GNU Affero General Public License v3.0 (**AGPL-3.0**). The governance layer must remain open, transparent, and auditable.
- **Sovereign Authority:** **Muhammad Arif bin Fazil** (F13 SOVEREIGN). Human veto is absolute. No autonomous agent or external service can bypass an `888_HOLD` or `VOID` verdict.
---
*DITEMPA BUKAN DIBERI — Forged, Not Given.*
*Truth must cool before it rules. 999 SEAL ALIVE.*