mcp-name: io.github.ariffazil/arifos

   █████╗ ██████╗ ██╗███████╗ ██████╗ ███████╗
  ██╔══██╗██╔══██╗██║██╔════╝██╔═══██╗██╔════╝
  ███████║██████╔╝██║█████╗  ██║   ██║███████╗
  ██╔══██║██╔══██╗██║██╔══╝  ██║   ██║╚════██║
  ██║  ██║██║  ██║██║██║     ╚██████╔╝███████║
  ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝      ╚═════╝ ╚══════╝

  Constitutional AI Governance Kernel
  ─────────────────────────────────────────
  Not a chatbot. Not a model wrapper. The LAW.

Quick Connect

New agents: Read ZEN.md first — it is the minimum viable context.

TL;DR — Three Audiences

For human operators (Arif): arifOS is the constitutional judge. It decides what agents may NOT do so they can be trusted with what they CAN do. You (F13) hold the final veto. §1

For AI agents: arifOS is your governance kernel. Init a session, observe reality, think, route to organs, and — after judge clearance — execute. 8 canonical verbs. Never skip the chain. §3

For developers/institutions: arifOS is a Python 3.12 FastMCP kernel enforcing 13 constitutional floors across 6 federation organs. Public endpoint at https://mcp.arif-fazil.com/mcp. §2

1. What Is arifOS?

arifOS is a constitutional governance kernel that sits between AI agents and their tools, enforcing 13 floors before any irreversible action.

Trinity role: arifOS = LAW/JUDGMENT. The judge. AAA = STATE/ROUTING. A-FORGE = EXECUTION/MUTATION.

2. Quick Start

Human Operators

• Cockpit: https://aaa.arif-fazil.com
• Telegram: @ASI_arifos_bot
• Health: https://arifos.arif-fazil.com/health

AI Agents (MCP Clients)

{
  "mcpServers": {
    "arifOS": {
      "url": "https://mcp.arif-fazil.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Developers

git clone [email protected]:ariffazil/arifos.git && cd arifOS
uv sync --all-extras
python -m arifosmcp.runtime.server           # starts on :8088
curl http://127.0.0.1:8088/health
python -m pytest tests/ -q --tb=short

3. The 8 Canonical Public Tools

All tools use arif_<verb> naming. Internal aliases are absorbed as modes on canonical tools. Exactly 8 tools on the wire.

000 → 111 → 333 → 444 → 555 → 888 → 777 → 999
init → observe → think → route → memory → judge → forge → seal

Internal aliases (absorbed into canonical modes): arif_triage → arif_init(preflight), arif_critique → arif_think(critique), arif_bridge_connect → arif_route(bridge), arif_act → arif_forge

Source of truth: tools/list (runtime) beats any static manifest.

4. The 13 Constitutional Floors

HARD violation → VOID (blocked). SOFT tension → CAUTION/HOLD. DERIVED → informational.

5. Federation Architecture

                         ┌──────────────────────┐
                         │  Arif (F13 SOVEREIGN) │
                         └──────────┬───────────┘
                                    │
       ┌────────────────────────────┼────────────────────────────┐
       │                            │                            │
  ┌────▼─────┐              ┌───────▼───────┐            ┌───────▼───────┐
  │  Hermes  │              │      AAA      │            │   OpenClaw    │
  │  🧠 :8644│              │  🖥️  :3001    │            │   🤖 :18789   │
  │ Telegram │              │   Cockpit     │            │  Transport    │
  └──────────┘              └───────────────┘            └───────────────┘
                                    │
                         ┌──────────▼──────────┐
                         │    arifOS (Ω)        │
                         │    Kernel :8088      │
                         │    F1-F13 · 888 JUDGE│
                         └──┬───┬───┬───┬──────┘
                            │   │   │   │
          ┌─────────────────┼───┼───┼───┼─────────────────┐
          │                 │   │   │   │                 │
    ┌─────▼────┐   ┌───────▼┐ ┌▼─────┐ ┌▼────────┐  ┌────▼─────┐
    │  GEOX    │   │WEALTH  │ │ WELL │ │A-FORGE  │  │ VAULT999 │
    │  🌍 :8081│   │💰:18082│ │🫀:18083│ │⚒️:7071  │  │ 🔒 Seal  │
    │ Evidence │   │Compute │ │Reflect│ │Execute  │  │ Immutable│
    └──────────┘   └────────┘ └──────┘ └─────────┘  └──────────┘

Authority chain: Arif → AAA/Hermes → arifOS → Domain Organs → A-FORGE → VAULT999

6. Build, Test, Deploy

# Development
uv sync --all-extras
uv run python -m arifosmcp.runtime.server
python -m pytest tests/ -q --tb=short
ruff check . && ruff format .

# Deploy to VPS
make deploy-local                  # rsync + systemctl restart arifos
systemctl status arifos

# Docker
docker build -t ghcr.io/ariffazil/arifos:latest .

7. MCP Connection Guide

Public Endpoint

Internal Organs

Rule: arifOS judges → A-FORGE executes → VAULT999 records. Never skip the chain.

Connecting from ChatGPT, Claude, Cursor

{ "mcpServers": { "arifOS": { "url": "https://mcp.arif-fazil.com/mcp" } } }

STDIO: npx -y arifos-mcp

Discovery

• MCP Server Card: .well-known/mcp/server.json
• Agent Card: https://aaa.arif-fazil.com/.well-known/agent-card.json
• MCP Manifest: https://arifos.arif-fazil.com/.well-known/mcp.json

📚 Documentation Index

Federation Context

8. License & Sovereignty

AGPL-3.0. The constitution must remain open. The kernel must remain inspectable.

Muhammad Arif bin Fazil is F13 SOVEREIGN. His veto is absolute. No algorithm overrides. No agent bypasses. No institution supersedes.

arifOS · Port 8088 · 8 canonical tools · 13 floors · 6 live organs
AGPL-3.0 · Sovereign: Arif Fazil · Federation: ALIVE
MCP · ChatGPT ✓ · Claude Desktop ✓ · PyPI
DITEMPA BUKAN DIBERI — 999 SEAL ALIVE

force unique hash 1784320830