Files
boardroom-map/instructions.md
T

48 lines
2.5 KiB
Markdown

# Boardroom Map
Drop confidential documents in and convene a **panel of local LLMs** running on
your DGX Sparks to review them. You choose the models, the personas (lenses), and
how many reviews. An optional **local lead reviewer** synthesizes the panel into
one consolidated report. There is **no frontier model and no cloud key** — in the
default air-gapped mode the documents and their reviews never leave your hardware.
Boardroom Map is a *control plane*: nothing serves or runs on your StartOS box (it only
SSHes to the Sparks and extracts document text on CPU).
## Setup (run the Actions in order)
1. **Configure Sparks** — SSH host/user/key for your head Spark (and optionally a
second), plus the work directory and image tags. Then **Test Spark Connection**.
2. **Configure Models** — the catalog of local models to serve (alias → HF id →
which Spark → port), and serving knobs. For air-gapped runs every model must be
on the **head Spark** and present in its HF cache.
3. **Configure Reviewers** — the panel: one entry per review, each a model + a
persona (the lens it reads through) + an optional temperature.
4. **Configure Review** — the rubric, the **Network Mode** (air-gapped vs
local-services), synthesis on/off + lead model, and whether to wipe documents
from the Sparks afterward.
## Running a review
1. Open the **Web UI** and drag your documents (PDF / DOCX / TXT / MD) onto the
inbox (or drop them in the service's `inbox` folder).
2. Click **Run Review** (or enable *auto-run on drop*).
3. Watch the activity log. The service extracts text locally, serves the needed
models on the Sparks **in waves** (so a panel can span more models than fit in
GPU memory at once), runs each reviewer, then the lead reviewer, and saves the
reports. Read them in the Web UI or via **View Latest Report**.
## Network modes
- **Air-gapped (default):** reviewer containers join an `--internal` Docker
network — they can reach only the on-Spark model proxy, with zero internet
egress. Models are served from a pre-pulled HF cache. All models must be on the
head Spark. Strongest confidentiality.
- **Local services:** reviewers may also reach LAN services (e.g. SearXNG) and the
second Spark. This network has egress unless you firewall it — use only when you
accept that reviewers can reach the network.
The original documents are extracted to plain text on the StartOS box; only that
text is shipped to the Sparks, and it is wiped from the Sparks after the job (the
reports are kept on your StartOS box).