Skip to main content

Requirements

  • Container orchestrator + Compose v2. Client VPS boxes use the same engine family; a desktop container GUI is optional and does not replace the engine.
  • uv (Astral) for repo Python.
  • Node 18+ only for this guide (website/) and apps/society-graph-ui.
  • An LLM destination: at least one of OPENAI_API_KEY / ANTHROPIC_API_KEY / GEMINI_API_KEY / OPENROUTER_API_KEY, or LMSTUDIO_BASE_URL.
  • For client auth: an OIDC identity provider tenant. Development may run with auth off.

Disk: the agents-host image is the heavy one (~4.5 GB uncompressed). An on-prem bundle compresses to ~2–3 GB.

No GPU is required on the VPS if models go through an API.