Run Vifu locally

Use this path when you are changing Vifu source code. PostgreSQL stays in Docker; the Rust runtime and Dashboard run directly from their own packages.

First-time setup

Install Dashboard dependencies once from the repository root:

bun install --frozen-lockfile

Then open three terminals.

1. Start PostgreSQL

docker compose -f docker-compose.yml -f docker-compose.local.yml up -d postgres

2. Start Vifu Server and Agent Gateway

cd crates/vifu
cargo run

On its first run, vifu creates local configuration under ~/.vifu and starts the Server and Agent Gateway together.

3. Start the Dashboard

cd npm-packages/dashboard
bun dev

Open http://localhost:6791. The runtime is available at http://127.0.0.1:6790.

Confirm the runtime

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

Create a project, then continue with Agent Providers.

Stop the Rust runtime and Dashboard with Ctrl-C. PostgreSQL remains available for the next session. To stop it too:

docker compose -f docker-compose.yml -f docker-compose.local.yml down