The Companion

The Companion is the ModelReins desktop app. It’s the first thing you install and the thing that runs in your system tray. It contains Bob (your local brain), the Wall (fleet dashboard), and a background worker that heartbeats to the fleet.

What it does

• Installs Bob — creates your local brain on first run, seeded from the Spore
• Runs the wizard — one-click setup: Ollama detection, model pull, account creation, worker registration
• The Wall — full-screen fleet dashboard with live workers, jobs, metrics, leaderboard, audit trail, and 14 navigable pages
• Background worker — heartbeats to your fleet, picks up jobs, routes through the local Ollama model
• System tray — lives in your tray when not actively viewing the Wall

Install

Download from app.modelreins.com/download.

Run the installer. The wizard handles everything in about 3 minutes.

The Wall

The Wall is the companion’s dashboard — a full-screen fleet view designed for a spare monitor. It rotates through pages automatically:

• Fleet — worker cards with status, model, and Director assignment
• Jobs — recent dispatches with status, worker, prompt, cost, duration
• Metrics — jobs today, success rate, tokens, cost, workers online
• Leaderboard — workers ranked by jobs completed
• Audit — recent actions with actor, timestamp, and detail
• 14-Day Trend — daily job volume bar chart
• Providers — active provider cards
• In Memoriam — retired workers, permanently honored
• Events — live event stream

Pages with no data auto-skip in the carousel.

System tray

The companion lives in your system tray when the Wall is closed:

• Green — worker active
• Blue — worker is processing a job
• Gray — worker offline

Right-click for version info, documentation link, and quit.

Configuration

The companion stores its config in %APPDATA%/@mediagato/modelreins-companion/.env. This is written automatically by the wizard. You shouldn’t need to edit it manually.

Platform support

Platform	Status
Windows	Fully supported
macOS	Planned
Linux	Planned