From Source

For contributors or if you prefer manual control over the installation.

Prerequisites

Bun v1.3 or later
A chat model — either a local server (llama.cpp, LM Studio) or a cloud API key (Bedrock, Gemini, OpenRouter)

Clone and install

git clone https://github.com/maziarzamani/spaceduck.git
cd spaceduck
bun install

Install system dependencies

# SQLite with extension support (required for sqlite-vec)
brew install sqlite

SQLite with extension support is typically available by default. If you get sqlite-vec errors, install libsqlite3-dev.

Configure deployment settings

cp .env.example .env

The .env file controls deployment knobs only (port, log level). Provider settings are managed in the Settings UI.

Start the gateway

bun run dev

Open http://localhost:3000 in your browser.