Quick Start

From zero to a talking warehouse.

Three downloads, four commands. Generate a realistic enterprise warehouse, start the server, open the desktop app, and let the agent build the whole pipeline.

⚠ Please evaluate thoroughly. VibeBI is free software without warranty. Before deploying it in any material capacity:

  • Test in a non-critical environment first
  • Validate outputs and behavior against your use case
  • Make your own informed decision about risk and fitness
  • See our Warranty Disclaimer for full terms
1 · Download
🖥️

VibeBI Desktop

The power-user app — BI Agent, DG Agent, Explorer, Store, and governance. macOS, Windows, Linux.

Download link coming soon — stay tuned
🧩

VibeBI Server

The on-prem control plane — auth, broker, report store, scheduling, and audit. Docker Compose pilot bundle.

Download link coming soon — stay tuned
🗄️

SimEDW generator

The "Amazing" fictional ecommerce sample-data generator — 45 source systems, 79 bronze tables in ClickHouse.

Download link coming soon — stay tuned
2 · Run

Four steps to BI.

Generate the SimEDW sample warehouse

Run the "Amazing Ecommerce" generator to populate a ClickHouse bronze database.

./scripts/init_amazing_clickhouse.sh
First run is slow. The generator builds the entire historical database (365 days, 79 tables). Subsequent runs are incremental and fast.

Start the VibeBI server

Bring up the on-prem control plane with the pilot Compose bundle. It exposes the platform on :8080.

docker compose -f compose/vibebi-pilot.yml up -d
# health check
curl http://localhost:8080/healthz

Open VibeBI Desktop & first-time setup

Launch the desktop app. On first run, point it at your server and warehouse in Warehouse Config, then select the amazing bronze database as the deployment root.

# Warehouse Config → Bronze root
Server URL:   http://localhost:8080
Bronze DB:    amazing

Let the DG agent build the pipeline

In the DG Agent chat, one line is enough. The agent profiles bronze, drafts silver and gold views, and proposes semantics — you approve the gates.

"Build the full semantics and gold models for the amazing database."
Happy Vibe BI'ing. Once gold is published, switch to the BI Agent and just ask: "Show me Prime Day revenue by category vs last year."
3 · Tell us

Bug, idea, or just hi?

Report a bug, suggest a feature, or reach out. Everything lands straight in our inbox.