One-link self-deploy¶
agent-utilities is self-deploying: point any SI agent (Claude Code, Cursor, Codex, Windsurf, …) at the repository and it knows how to set itself up — or run a single command the operator. There is one path for two very different operators:
- Homelabbers / self-hosters — a zero-infra, all-local stack on a laptop or Pi.
- Enterprises — a multi-host Docker Swarm with everything wired in (Vault, SSO, DNS, ingress, observability, and all 50+ MCP connectors).
One command¶
Pick a profile (defaults to tiny):
curl -fsSL https://knuckles-team.github.io/agent-utilities/install.sh | sh -s -- --profile enterprise
& ([scriptblock]::Create((irm https://knuckles-team.github.io/agent-utilities/install.ps1))) -DeployProfile enterprise
If the pretty URL is unavailable
The scripts are also fetchable raw from GitHub:
https://raw.githubusercontent.com/Knuckles-Team/agent-utilities/main/scripts/install.sh
(and install.ps1).
What the installer does¶
- Checks the operator's host (Python 3.11–3.14; no Rust needed — the engine ships as a
prebuilt wheel; Docker only above
tiny). - Installs agent-utilities (+ extras for the operator's profile) and the skill toolkit.
- Runs the host preflight for the operator's profile and any UI components the operator choose.
- Installs the skills into every SI tool on the operator's host and wires the
graph-osMCP server into each — so the operator's agent immediately has the knowledge graph and the genesis skills. - Hands off to a guided deployment that finishes the wiring.
Profiles¶
| The operator are… | Profile | What the operator get |
|---|---|---|
| A homelab / self-hoster | tiny |
Zero-infra, all-local. No databases, no Docker. |
| One durable server | single-node-prod |
Postgres/pg-age + the core MCP connector fleet. |
| An enterprise | enterprise |
Multi-host Swarm — Vault, SSO, DNS, ingress, observability, all 50+ connectors. |
Optional UIs (add --component): agent-webui, agent-terminal-ui, geniusbot.
For SI agents¶
The full deployment procedure lives in
AGENTS.md → Zero-to-deployed,
and the machine-readable manifest the operator loop over is
genesis.yaml
(profiles · preflight · MCP fleet · UI components · IDE targets). Preflight a host
without installing anything via the MCP tool
graph_configure action=preflight config_key=<profile>.