Home

blumi — Help & Setup

Welcome to the blumi wiki — the setup and help documentation for the CLI, the always-on gateway, the blugo phone app, and the distributed grid.

blumi is a local-first, provider-agnostic agentic coding companion: one Rust core, three faces — a terminal UI, a web UI, and a phone app — all driven by one shared session/event stream.

Pick your setup

You want to…	Start here
Use blumi in your terminal	Installation → CLI Usage
Configure providers / keys / models	Configuration
Drive blumi from your phone	Gateway → Mobile App
Run several machines as one fleet	Grid (distributed)
Talk to / hear blumi (voice)	Voice
Let the agent edit/rebuild itself	Self-Management
Hack on blumi	Development
Something's broken	Troubleshooting

The three common setups

1. Local (one machine). Install, blumi login, run blumi (TUI) or blumi web. Nothing else needed. → Installation, CLI Usage.

2. Gateway + phone. Run blumi serve as an always-on service on your machine; connect the blugo app over your Wi-Fi. → Gateway, Mobile App.

3. Grid (many machines). Install blumi on several machines, give them the same grid.secret; they auto-discover each other and hand off tasks. Your phone (or any node) drives the fleet. → Grid (distributed).

Conventions used here

• Config lives in ~/.blumi/settings.json (global) and a per-project .blumi/.
• The gateway service is com.blumi.serve (launchd, macOS) / blumi-serve (systemd user, Linux).
• Secrets (API keys, the grid secret, the gateway password hash) live in settings.json (mode 0600) — never in git.