io.github.ANAMIZED/server-os

Server OS

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.

A senior engineer who has never seen this repository can, using only the source code and this README.md:

1. Deploy the entire system (single command)
2. Exercise every major feature
3. Verify end-to-end correctness via automated checks

No prior context or tribal knowledge required.

Support Agentic OS Kernels ($99) · Agentic OS Cycle ($0.75) · Public Goods Support

Non-custodial USDC (preferred for agents)

Related: rui · LRSI · openmesha · OpenGOS · agenticarb · x402-cloudflare-starter

🚀 Web Control Plane (Hero Demo — Zero Install)

Canonical file: web/server-os.html (~82 KB)

Open locally:

python -m http.server 8088 --directory web
# http://127.0.0.1:8088/server-os.html

Or Chrome → File → Open File… → web/server-os.html.

Acceptance: open the file → OS tab → Golden evals → run → 12/12 passed.

Offline 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.

Quick Start (Production Runtime)

docker compose up --build
# another terminal
bash scripts/verify.sh

• API: http://localhost:8080
• Dashboard: http://localhost:8080/dashboard
• OpenAPI: http://localhost:8080/docs

Default mode is offline mock LLM (deterministic, free). Set SERVER_OS_LLM_MODE=openai + OPENAI_API_KEY for real models.

Surfaces

Verify contract

bash scripts/verify.sh

Covers API, cost, governance, multi-agent workflows, SDK, CLI, MCP, skills, and AGENTS.md. 16 checks. All must pass.

Web parity check (manual, ~30s): open full web/server-os.html → run Golden evals → 12/12.

Design principles

1. Least privilege by construction (capabilities from intent)
2. Cost is a first-class resource
3. Observable by default
4. Fail closed
5. Deployable with zero tribal knowledge

License

Apache-2.0