Installation

Installation

blumi is a single binary. Install it, then run blumi login to pick a provider.

Quick install (macOS / Linux)

curl -fsSL https://raw.githubusercontent.com/ankurCES/blumi-cli/main/install.sh | sh

This installs blumi into ~/.local/bin (override with BLUMI_INSTALL_DIR). It downloads a prebuilt release for your platform when available, otherwise builds from source with cargo.

Make sure ~/.local/bin is on your PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc   # or ~/.bashrc

From source (needs Rust)

Install Rust from https://rustup.rs, then:

# install the published crate
cargo install --git https://github.com/ankurCES/blumi-cli --locked blumi

# or clone + build
git clone https://github.com/ankurCES/blumi-cli && cd blumi-cli
cargo install --path crates/blumi --locked

A plain cargo build needs no JS/Node toolchain — the React web UI's built dist/ is committed and embedded.

Optional features

Some backends are feature-gated to keep the default build lean:

cargo install --path crates/blumi --locked --features docker,ssh,lsp

• docker — run tools inside a container (--sandbox docker)
• ssh — run tools on a remote host over SSH
• lsp — the code-intel LSP tool

External tools

blumi shells out to a few common tools when present (all optional):

• git / gh — version control + GitHub operations the agent performs.
• Node + uv — used by default MCP servers; the installer offers to set these up. See CLI Usage → mcp.

Verify

blumi --version
blumi --help

Mobile app toolchain (only if you'll build blugo)

To build the blugo phone app you need Flutter; see Mobile App. You do not need Flutter to use the CLI or the gateway.

Next

• Configuration — providers, keys, models.
• CLI Usage — the commands.
• Gateway — run it always-on for the phone app.