{
  "markdown": "# Server OS\n\n[![CI](https://github.com/ANAMIZED/server-os/actions/workflows/ci.yml/badge.svg)](https://github.com/ANAMIZED/server-os/actions/workflows/ci.yml)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![MCP](https://img.shields.io/badge/MCP-server-purple.svg)](src/server_os/mcp/)\n[![SDK](https://img.shields.io/badge/SDK-Python-green.svg)](src/server_os/sdk/)\n[![CLI](https://img.shields.io/badge/CLI-server--os-orange.svg)](src/server_os/cli.py)\n[![API](https://img.shields.io/badge/API-FastAPI-009688.svg)](src/server_os/api/)\n\n**Autonomous Agentic Operating System** — agents as first-class processes with cost control, governance, observability, MCP, SDK, CLI, and skills. Fail-closed. Verified end-to-end.\n\nA senior engineer who has never seen this repository can, using **only** the source code and this `README.md`:\n\n1. Deploy the entire system (single command)\n2. Exercise every major feature\n3. Verify end-to-end correctness via automated checks\n\nNo prior context or tribal knowledge required.\n\n**[Support Agentic OS Kernels ($99)](https://buy.stripe.com/bJecN63wObPv6Bf7Zm43S02)** · **[Agentic OS Cycle ($0.75)](https://buy.stripe.com/3cI14o8R8dXD3p3frO43S04)** · **[Public Goods Support](https://donate.stripe.com/00w5kE3wOg5L8Jn2F243S00)**\n\n### Non-custodial USDC (preferred for agents)\n\n| Network | Address | Explorer |\n|---------|---------|----------|\n| **Base** | `0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438` | [basescan](https://basescan.org/address/0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438) |\n| **Ethereum** | `0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438` | [etherscan](https://etherscan.io/address/0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438) |\n| **Solana** | `ETQwWf19axArsY493UfC6bxe2BmEzmzvCb58PPnC38A` | [solscan](https://solscan.io/account/ETQwWf19axArsY493UfC6bxe2BmEzmzvCb58PPnC38A) |\n\n*Related:* [rui](https://github.com/ANAMIZED/rui) · [LRSI](https://github.com/ANAMIZED/LRSI) · [openmesha](https://github.com/ANAMIZED/openmesha) · [OpenGOS](https://github.com/ANAMIZED/OpenGOS) · [agenticarb](https://github.com/ANAMIZED/agenticarb) · [x402-cloudflare-starter](https://github.com/ANAMIZED/x402-cloudflare-starter)\n\n---\n\n## 🚀 Web Control Plane (Hero Demo — Zero Install)\n\n**Canonical file:** [`web/server-os.html`](web/server-os.html) (~82 KB)\n\nOpen locally:\n\n```bash\npython -m http.server 8088 --directory web\n# http://127.0.0.1:8088/server-os.html\n```\n\nOr Chrome → **File → Open File…** → `web/server-os.html`.\n\n**Acceptance:** open the file → **OS** tab → **Golden evals → run** → **12/12 passed**.\n\nOffline mock provider, policy, budgets, graph, terminal, and 12 golden evals. The HTML engine is DOM-free below the UI so the eval suite exercises the same path as interactive use.\n\n---\n\n## Quick Start (Production Runtime)\n\n```bash\ndocker compose up --build\n# another terminal\nbash scripts/verify.sh\n```\n\n- API: http://localhost:8080\n- Dashboard: http://localhost:8080/dashboard\n- OpenAPI: http://localhost:8080/docs\n\nDefault mode is **offline mock LLM** (deterministic, free). Set `SERVER_OS_LLM_MODE=openai` + `OPENAI_API_KEY` for real models.\n\n---\n\n## Surfaces\n\n| Surface | Entry |\n|---------|-------|\n| **Web control plane** | `web/server-os.html` (offline, self-verifying) |\n| REST API | `python -c \"from server_os.main import run; run()\"` |\n| CLI | `server-os status` / `server-os agents ...` |\n| MCP Server | `server-os-mcp` |\n| SDK | `from server_os.sdk import ServerOSClient` |\n| Multi-agent workflows | `skills/multi-agent-workflow/` |\n| Skills | `skills/*/SKILL.md` |\n| AGENTS.md | Coding-agent contract at repo root |\n| CI | `.github/workflows/ci.yml` |\n\n## Verify contract\n\n```bash\nbash scripts/verify.sh\n```\n\nCovers API, cost, governance, multi-agent workflows, SDK, CLI, MCP, skills, and AGENTS.md. **16 checks. All must pass.**\n\n**Web parity check (manual, ~30s):** open full `web/server-os.html` → run **Golden evals** → 12/12.\n\n## Design principles\n\n1. Least privilege by construction (capabilities from intent)\n2. Cost is a first-class resource\n3. Observable by default\n4. Fail closed\n5. Deployable with zero tribal knowledge\n\n## License\n\nApache-2.0\n",
  "bytes": 4245,
  "sha": "da7e8e34b9341cc52ed1cc6eaf580d37100027cb3ce7b4aefa31a3432f65d153",
  "repo_slug": "anamized/server-os",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_anamized_server_os_abeceeba/readme"
}