Self-hostingRun Vifu locally
View Markdown

Run Vifu locally

The release binary is the shortest local path. It starts Vifu Server, Agent Gateway, the live TUI, and the embedded Dashboard as one application.

Release binary

The installer selects the native binary for your platform from the current GitHub Release:

curl -fsSL https://vifu.dev/cli | bash
vifu

You can also download and extract the archive manually, then run:

./vifu

Vifu stores local state under ~/.vifu, listens on http://127.0.0.1:6790, and opens the TUI. Press B to open the Dashboard. No separate Console process or project bootstrap is required.

Source checkout

Install the JavaScript workspace once, then use the repository command that builds the embedded Dashboard before it starts Rust:

bun install --frozen-lockfile
cargo vifu

cargo vifu runs bun run build:console followed by cargo run -p vifu. Arguments after -- are forwarded to Vifu.

cargo vifu -- -c server.address=http://0.0.0.0:6790

Use a LAN listener only on a trusted network. The local Dashboard and API share the Server address; 127.0.0.1 is reachable only from the computer itself.

Verify

curl --fail --silent http://127.0.0.1:6790/health

Quit with Q in the TUI. Continue with Agent Providers to connect an Agent or model.