vibesboarddocs

Quickstart#

This gets a local Vibesboard instance running with Docker Compose: Postgres, MinIO for object storage, and the Next.js app.

Requirements#

  • Bun 1.2.18
  • Node.js 22
  • Docker with Compose
  • An OpenAI API key for the platform fallback model

Install and run#

Clone the repository

git clone https://github.com/NordicAgents/vibeagent.git
cd vibeagent
bun install

Configure environment variables

Copy the example environment file and fill in the placeholder credentials and secrets, including your OpenAI API key.

cp .env.example .env

Start infrastructure and seed the database

This starts Postgres and MinIO, creates the local bucket, runs migrations, and seeds the database.

bun run db:setup

Start the app

bun run dev

Open http://localhost:3000.

Full environment reference

See Environment variables for every configuration value and what it's for.

Next steps#

Core concepts

Understand workspaces, agents, knowledge, and memory before building.

Create your first agent

Build, preview, and publish an agent with the AI-assisted builder.

NextCore concepts