arifos

Overview

ArifOS is a constitutional governance kernel that implements 13 constitutional floors (F1-F13) to provide controlled AI agent execution. It exposes a canonical MCP server with 13 tools that pass through intent validation → constitutional floor checks → verdict before action. The system includes a VAULT999 append-only ledger for auditability and integrates with various federated components like AAA (body), A-FORGE (forge), and GEOX (field). The MCP runtime is built on FastMCP and FastAPI with support for both HTTP/SSE and stdio transports.

Try asking AI

After installing, here are 3 things you can ask your AI assistant:

• arif_session_init

  Bind actor identity and set safety state to HOLD

  Try:Initialize a new actor sessionTry:Start a new governed interaction session
• arif_sense_observe

  Ground in reality by observing web, VPS vitals, and atlas

  Try:Observe current web environmentTry:Get system vital statisticsTry:Ground reality with atlas data
• arif_evidence_fetch

  Fetch external data from oracles like GEOX, FRED, EIA

  Try:Fetch economic data from FREDTry:Get geoscientific data from GEOXTry:Retrieve energy data from EIA
• arif_mind_reason

  Perform structured reasoning with contradiction detection

  Try:Analyze this data for contradictionsTry:Reason through this complex problemTry:Detect inconsistencies in the argument
• arif_kernel_route

  Route tasks based on risk orthogonality in AGI/ASI/APEX lanes

  Try:Route this query to the appropriate laneTry:Assess risk orthogonality for this taskTry:Determine execution path based on AGI/ASI classification
• arif_reply_compose

  Compose a governed response with constitutional checks

  Try:Compose a response following constitutional guidelinesTry:Draft a reply that passes F1-F13 checksTry:Create a safe, governed response
• arif_memory_recall

  Access semantic memory and skill registry

  Try:Recall relevant information from memoryTry:Find a skill in the registryTry:Search past interactions for this context
• arif_heart_critique

  Perform adversarial critique through F5/F6/F9 floors

  Try:Critique this response with adversarial checksTry:Apply F5/F6/F9 quality filtersTry:Perform adversarial evaluation
• arif_gateway_connect

  Connect to A2A mesh under constitutional governance

  Try:Connect to the A2A gateway meshTry:Establish a governed mesh connectionTry:Link to other agents under F1-F13
• arif_ops_measure

  Measure Landauer cost and reversibility classification

  Try:Measure computational cost of this operationTry:Classify reversibility of this taskTry:Assess thermodynamic efficiency
• arif_judge_deliberate

  Deliberate and return SEAL/HOLD/VOID/SABAR verdict

  Try:Deliberate and return a verdict on this taskTry:Apply judge protocol to determine actionTry:Evaluate compliance with constitutional floors
• arif_vault_seal

  Create immutable Merkle-V3 ledger anchor

  Try:Seal this data in the immutable vaultTry:Create a Merkle-V3 anchor recordTry:Add an immutable entry to the audit ledger

Comparable tools

Installation

# Install from PyPI
pip install arifos

# Install from source (editable, with dev extras)
pip install -e ".[dev]"

# Run MCP server (HTTP + SSE)
python -m arifosmcp.server
# or via module:
python -m arifosmcp.runtime.__main__

# Run MCP server (stdio transport)
python -m arifosmcp.runtime.__main__ --mode stdio

{
  "mcpServers": {
    "arifos": {
      "command": "python",
      "args": ["-m", "arifosmcp.runtime.__main__", "--mode", "stdio"]
    }
  }
}

Compare arifos with