ariffazil/arifos

GitHub: ariffazil/arifos

arifOS 是一个基于 MCP 协议的 AI Agent 宪法治理内核,通过 13 条宪法底线和分阶段强制校验流程来约束和审计自主代理的每一步执行决策。

Stars: 49 | Forks: 8

``` █████╗ ██████╗ ██╗███████╗ ██████╗ ███████╗ ██╔══██╗██╔══██╗██║██╔════╝██╔═══██╗██╔════╝ ███████║██████╔╝██║█████╗ ██║ ██║███████╗ ██╔══██║██╔══██╗██║██╔══╝ ██║ ██║╚════██║ ██║ ██║██║ ██║██║██║ ╚██████╔╝███████║ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚═╝ ╚═════╝ ╚══════╝ Constitutional AI Governance Kernel ───────────────────────────────────────── Not a chatbot. Not a model wrapper. The LAW. ``` **DITEMPA BUKAN DIBERI** — *"百炼而成,非天赐。"*
[![CI](https://static.pigsec.cn/wp-content/uploads/repos/cas/29/291ba2d42f3d960e813cbab50e72b71b42cb955224288d2d5c7c0009528d847a.svg)](https://github.com/ariffazil/arifos/actions/workflows/01-unified-ci.yml) [![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13-3776AB?logo=python)](https://pypi.org/project/arifos/) [![MCP](https://img.shields.io/badge/MCP-10%20verbs%20public-10b981)](https://mcp.arif-fazil.com/mcp) [![Floors](https://img.shields.io/badge/floors-F1–F13%20active-f59e0b)](arifosmcp/core/floors.py) [![License](https://img.shields.io/badge/license-AGPL--3.0-ef4444)](LICENSE) [![Federation](https://img.shields.io/badge/federation-7%20organs%20alive-8B5CF6)](FEDERATION_STATUS.md) [![PyPI](https://img.shields.io/pypi/v/arifos?label=pypi)](https://pypi.org/project/arifos/) [![Glama](https://img.shields.io/badge/Glama-arifOS-8A2BE2)](https://glama.ai/mcp/servers/ariffazil/arifos) [![Smithery](https://img.shields.io/badge/Smithery-arifOS-FF6B35)](https://smithery.ai/server/ariffazil/arifos) [![mcp.so](https://img.shields.io/badge/mcp.so-arifOS-00BFFF)](https://mcp.so/servers/ariffazil/arifos) ## 1. 什么是 arifOS? - **法则层** — 决定 agent 绝对不能做的事,从而让它们在能做的事上获得信任 - **一个 MCP server** — 10 个公开动词。Agent 调用 `arif_init` → `arif_judge` → `arif_seal` - **一个联邦枢纽** — 7 个器官(arifOS, A-FORGE, GEOX, WEALTH, WELL, AAA, VAULT999)置于同一契约之下 - **一个不可变的账本** — VAULT999:只追加,哈希链式结构。每一个决策被永久封存 - **为唯一的 sovereign 而建** — Muhammad Arif bin Fazil。F13 否决权是绝对的 **它不是什么:** 一个 AI 模型、一个聊天机器人、一个初创公司、LangChain/CrewAI/AutoGen,或者是人类判断的替代品。 ## APEX STACK 桥接 **arifOS 绝对不能:** 取代人类判断、自行授权执行 SEAL、跳过 888_JUDGE,或在缺乏宪法链条的情况下下达判决。 完整准则:[GENESIS/040_APEX_STACK.md](https://github.com/ariffazil/arifos/blob/main/GENESIS/040_APEX_STACK.md) ## 2. 快速开始 ### 人类操作员 你不需要安装 arifOS。你可以通过以下方式与之交互: - **AAA Cockpit:** https://aaa.arif-fazil.com - **Hermes Telegram:** `@ASI_arifos_bot` - **健康检查:** https://arifos.arif-fazil.com/health ### AI Agent (MCP 客户端) ``` { "mcpServers": { "arifOS": { "url": "https://mcp.arif-fazil.com/mcp", "transport": "streamable-http" } } } ``` ### 开发者 ``` pip install arifos # from PyPI # 或 git clone git@github.com:ariffazil/arifos.git && cd arifOS uv sync --frozen python -m arifosmcp.server # starts on :8088 curl http://127.0.0.1:8088/health # verify python -m pytest tests/ -q --tb=short # 4,400+ tests ``` ## 3. 10 个公开工具 每一个受管治的行动都遵循黄金路径。888 是闸门。999 是封印。 | # | 工具 | 阶段 | 功能描述 | |---|------|-------|---------------| | 1 | `arif_init` | 000 | 开启宪法会话。永远排在第一步。 | | 2 | `arif_observe` | 111 | 收集证据 — 网络搜索、URL 抓取、系统关键指标 | | 3 | `arif_think` | 333 | 推理、规划、批判、验证 — 多步认知 | | 4 | `arif_route` | 444 | 将意图路由到正确的联邦器官 | | 5 | `arif_judge` | 888 | 宪法判决 — SEAL / HOLD / SABAR / VOID | | 6 | `arif_act` | 900 | 仅在 888 下达 SEAL 时执行 | | 7 | `arif_seal` | 999 | 追加至不可变的 VAULT999 账本 | | 8 | `arif_resolve_tool` | — | 将工具名称解析为规范形式 | | 9 | `arif_vault_query` | — | 查询 VAULT999 审计账本 | | 10 | `arif_conformance_report` | — | 完整的 9 项检查宪法核心链条证明 | ``` 000 ──→ 111 ──→ 333 ──→ 444 ──→ 888 ──→ 900 ──→ 999 init observe think route judge act seal ``` **铁律:** 任何行动都不能跳过 888。任何器官都不能自行授权。 ## 4. 13 个宪法底线 每一次工具调用都会经过这些底线。硬性底线阻断操作。软性底线发出警告。 | # | 底线 | 类型 | 规则 | |---|-------|------|------| | **F1** | AMANAH | HARD | 可逆操作优先。不可逆操作 → 888 HOLD | | **F2** | TRUTH | HARD | P(真值) ≥ 0.99。捏造 = VOID | | **F3** | WITNESS | DERIVED | 高破坏性操作需要多方共识 | | **F4** | CLARITY | HARD | 每次输出必须降低熵 (ΔS ≤ 0) | | **F5** | PEACE² | SOFT | 非破坏性力量。伤害潜力 < 0.30 | | **F6** | EMPATHY | SOFT | 保护最弱势的利益相关者 | | **F7** | HUMILITY | HARD | 置信度上限设为 0.90。没有虚假的确信 | | **F8** | GENIUS | DERIVED | 复杂操作需要高信噪比 | | **F9** | ANTIHANTU | HARD | 禁止欺骗、操纵或声称具有意识 | | **F10** | ONTOLOGY | HARD | AI 只是工具。没有灵魂,没有感情 | | **F11** | AUDIT | HARD | 每一项决策都必须被记录且可供审查 | | **F12** | RESILIENCE | HARD | 防注入防御。风险受控 | | **F13** | SOVEREIGN | HARD | 人类否决权具有最高效力。最强底线 | **HARD 违规 → VOID。** 阻断操作。**SOFT 冲突 → CAUTION/HOLD。** 转交人类审查。**DERIVED → 仅供参考。** 完整规格说明:`static/arifos/theory/000/000_CONSTITUTION.md` ## 5. 联邦架构 arifOS 是内核。六个器官在其之下运行。两个边缘 agent 负责与外界交互。 ``` ┌──────────────────────┐ │ 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│ └──────────┘ └────────┘ └──────┘ └─────────┘ └──────────┘ ``` | 器官 | 端口 | 角色 | 绝对不能 | |-------|------|------|------------| | **arifOS** | 8088 | 宪法内核 | 自行授权 | | **GEOX** | 8081 | 地球智能 | 授权钻探 | | **WEALTH** | 18082 | 资本智能 | 分配资本 | | **WELL** | 18083 | 人类准备度 | 进行医学诊断 | | **AAA** | 3001 | 控制平面 / 驾驶舱 | 下达宪法判决 | | **A-FORGE** | 7071/7072 | 执行外壳 | 自行授权 | | **VAULT999** | — | 不可变审计账本 | 编辑或删除记录 | | **Hermes** | 8644 | Telegram MIND 边缘 | 下达宪法判决 | | **OpenClaw** | 18789 | 传输 HANDS 边缘 | 下达宪法判决 | **权限链:** Arif → AAA/Hermes → arifOS 内核 → 领域器官 → A-FORGE → VAULT999 ## 6. 构建、测试、部署 ``` # Development uv sync --frozen python -m arifosmcp.server python -m pytest tests/ -q --tb=short # 4,400+ tests ruff check . && ruff format . # 部署到 VPS make deploy-local # rsync + systemd restart systemctl status arifos # Docker docker build -t ghcr.io/ariffazil/arifos:latest . ``` ## 7. MCP 连接指南 ### 公共 Endpoint ``` https://mcp.arif-fazil.com/mcp ``` 传输协议:`streamable-http`。先初始化会话,然后再调用工具。 ### 内部器官 | 器官 | Endpoint | 何时使用 | |-------|----------|-------------| | **arifOS** | `localhost:8088` | 管治、判决、路由 | | **A-FORGE** | `localhost:7071` | 构建、部署、文件系统、git、docker | | **GEOX** | `localhost:8081` | 地震波、油井、岩石物理 | | **WEALTH** | `localhost:18082` | 净现值 (NPV)、风险、资金流 | | **WELL** | `localhost:18083` | 活力、准备度、尊严 | **规则:** arifOS 判决 → A-FORGE 执行 → VAULT999 记录。绝不能跳过该链条。 ### 联邦背景(阅读全部 3 项以了解全貌) | 阅读此项 | 用途 | 链接 | |-----------|-----|------| | **arifOS**(本仓库) | 宪法内核。10 个动词。13 个底线。判决者。 | ← 你在此处 | | **A-FORGE** | 执行者。75 个 MCP 工具。闸门 + A-THINK 法则。 | [`ariffazil/A-FORGE`](https://github.com/ariffazil/A-FORGE) | | **AAA** | 驾驶舱。A2A mesh。Agent 注册表。React 19 仪表盘。 | [`ariffazil/AAA`](https://github.com/ariffazil/AAA) | ## 8. 许可证与主权 **AGPL-3.0。** 宪法必须保持开源。内核必须保持可审查。 **Muhammad Arif bin Fazil** 是 F13 SOVEREIGN。他的否决权是绝对的。任何算法都不能凌驾其上。任何 agent 都不能绕过它。任何机构都不能取代它。
``` arifOS · Port 8088 · 10 public verbs · 13 floors · 7 organs AGPL-3.0 · Sovereign: Arif Fazil · Federation: ALIVE DITEMPA BUKAN DIBERI — 999 SEAL ALIVE ```
标签:AI治理, MCP协议, Python, 人工智能, 无后门, 智能体框架, 用户模式Hook绕过, 请求拦截, 逆向工具