# 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](https://github.com/vifudotdev/vifu/releases/latest):

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

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

```bash
./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:

```bash
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.

```bash
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

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

Quit with `Q` in the TUI. Continue with [Agent Providers](/docs/agent-providers)
to connect an Agent or model.