VibeBIVibeBI
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.

VibeBI Server

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

SimEDW generator

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

Get the download link

One link covers all three — Desktop, Server, and SimEDW.

2 · Run

Five 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

Configure the Desktop app

Launch VibeBI Desktop. Add your ClickHouse instance in Settings → Connections, set your LLM provider in Settings → LLM, then go to Warehouse Config and select the amazing bronze database as the deployment root.

# Settings → Connections
Type:        ClickHouse
Host:        localhost
User:        default

# Settings → LLM
Provider:    Anthropic / OpenAI / Custom endpoint
API Key:     your-api-key

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

Let the DG agent build the pipeline

Open the DG Agent and give it one line. The agent profiles bronze, drafts silver and gold views, and proposes governed semantics — you approve the gates.

"Build the full semantics and gold models for the amazing database."

Happy Vibe BI'ing

Once the DG agent publishes gold, switch to the BI Agent and ask anything in plain English. Your warehouse talks back.

"Show me Prime Day revenue by category vs last year."
You're live. The BI Agent understands your semantics — ask follow-ups, drill down, or request visualizations. This is governed, self-service BI. Stewards: after BI usage, open Gold → BI Learning to process chat signals and grow gold from real demand — see technology §5.
3 · Tell us

Bug, idea, or just hi?

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