-
Notifications
You must be signed in to change notification settings - Fork 0
Home
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.
| 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) |
| Give blumi memory + understand your code | Memory & Knowledge |
| Talk to / hear blumi (voice) | Voice |
| Let the agent edit/rebuild itself | Self-Management |
| Hack on blumi | Development |
| Something's broken | Troubleshooting |
-
Local (one machine). Install,
blumi login, runblumi(TUI) orblumi web. Nothing else needed. → Installation, CLI Usage. -
Gateway + phone. Run
blumi serveas an always-on service on your machine; connect the blugo app over your Wi-Fi. → Gateway, Mobile App. -
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).
- 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(mode0600) — never in git.