Quick Start ~5 min

Prerequisites

Tool	Version	Install
Bun	≥ 1.0	curl -fsSL https://bun.sh/install | bash
Docker + Compose	≥ 20.10	docs.docker.com

---

1. Clone

git clone https://github.com/VENIZIA-AI/veni-ai.git
cd veni-ai

2. Start infrastructure

Windows

.\start-shell.ps1

Linux / macOS

./scripts/start-infrastructure.sh

Keycloak takes ~60 s to initialise

Wait for Keycloak 23 on JVM started in the logs before running migrations.

3. Shell API

cd shell/api
bun install
cp .env.example .env     # set APP_ENV_DATABASE_URL + APP_ENV_JWT_SECRET at minimum
bun run db:migrate
bun run dev

✓ API ready at http://localhost:3000/api/health

4. Shell UI

cd shell/ui
bun install
bun run dev

✓ UI ready at http://localhost:5173

5. Log in

Open http://localhost:5173 and use the default test account:

Field	Value
Username	veni
Password	veni

---

What's next

Installation	Infrastructure detail, full .env example
Configuration	All APP_ENV_* variables explained
Create a service	Scaffold your first micro-frontend
Keycloak setup	Configure your own realm