From e68369b256287344142645481ceeab879f911665 Mon Sep 17 00:00:00 2001 From: iris Date: Mon, 24 Aug 2026 19:11:13 +0200 Subject: [PATCH] README: add the swarm tier to the architecture diagram The diagram was single-hive only - no mention of swarm-controller, swarm-ui, authelia SSO, the metrics/log stores, Grafana, NATS or the swarm-level otel collector, despite all of them being real, shipped services (several on by default via enableAllLocalDefaults). Adds a swarm section alongside agent containers, same terse one-line-per- service style the existing optional-containers section already uses. swarm-ui gets a note that it has no own container (served straight from the gateway's nginx, unlike every sibling swarm service). --- README.md | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index d3b5d0df..04b472c0 100644 --- a/README.md +++ b/README.md @@ -33,9 +33,19 @@ host (NixOS, runs hive-c0re.service) │ ├── hive-forge Forgejo — per-agent accounts, config mirror (agent-configs/) │ └── hive-matrix tuwunel — Matrix homeserver + per-agent accounts │ -└── agent containers - ├── h-ruth manager (privileged MCP surface, approval gating) - └── h- sub-agent (claude + MCP tools + per-agent web UI + unix socket) +├── agent containers +│ ├── h-ruth manager (privileged MCP surface, approval gating) +│ └── h- sub-agent (claude + MCP tools + per-agent web UI + unix socket) +│ +└── swarm (optional — connects hives; one host per swarm runs these) + ├── swarm-controller cross-hive state: hive directory, agent roster, jobs + ├── swarm-ui swarm-wide SPA, served straight off the gateway (no own container) + ├── swarm-authelia SSO — one login gates swarm-ui + Grafana + more + ├── swarm-nats message queue (JetStream KV: hive-status, …) + ├── swarm-otel telemetry collector, sole holder of the upstream credential + ├── swarm-victoriametrics metrics store + ├── swarm-victorialogs log store + └── swarm-grafana dashboards over the metrics/log stores, own OIDC login ``` **[→ website](https://hyperhive.darkest.space)** ·