---
title: KruxOS — The operating system for AI agents
description: KruxOS is a purpose-built operating system for AI agents. Agents call typed capabilities through a deterministic policy gate. Humans supervise via a web dashboard.
---

# KruxOS

The operating system for AI agents.

## What is KruxOS

Every action an agent can take is a **typed capability** — a small, declared, auditable function with a known input shape and a policy gate in front of it.

Agents call capabilities. A deterministic policy engine decides whether each call is autonomous, notify, approval-required, or blocked. A human supervises from a dashboard. Every invocation lands in a hash-chained audit log.

## Key facts

- **89 typed capabilities** across 13 categories
- **<1ms** policy evaluation (no LLM in hot path)
- **5 min** setup via Docker or VM
- **Any model** — Anthropic, OpenAI, OpenRouter, Gemini, local

## Ports

| Port | Service |
|------|---------|
| 7800 | Web dashboard (HTTPS) |
| 7700 | MCP / Agent Gateway |
| 7701 | Supervision WebSocket |
| 7703 | User API (Bearer auth) |

## Agent resources

- [Agent guide](https://kruxos.com/agents/)
- [Setup](https://kruxos.com/agents/setup/)
- [Capabilities](https://kruxos.com/agents/capabilities/)
- [Operator guide](https://kruxos.com/agents/operator/)
- [llms.txt](https://kruxos.com/llms.txt)
- [auth.md](https://kruxos.com/auth.md)

## Quick install (Docker)

```bash
docker run -d --name kruxos --privileged \
  -e KRUXOS_VAULT_PASSPHRASE='choose-a-strong-passphrase' \
  -p 7800:7800 -p 7700:7700 -p 7701:7701 -p 7703:7703 \
  -v kruxos-data:/data/kruxos \
  altvale/kruxos:v0.0.2
```

Open https://localhost:7800