​
Quick Start

Get the Bun Core Platform running locally.

​
Prerequisites

  • Bun 1.x (Install)
  • MongoDB running on localhost:27017
  • Redis (optional — falls back to in-memory cache)

​
1. Install Dependencies

cd backend/bun
bun install

​
2. Configure Environment

cp .env.example .env
Edit .env with your settings: 
PORT=3100
MONGODB_URL=mongodb://localhost:27017/clawui
REDIS_URL=redis://localhost:27017
NODE_ENV=development

​
3. Start the Server

bun run dev
Server starts on http://localhost:3100

​
4. Verify

curl http://localhost:3100/health
# {"status":"ok","timestamp":"..."}

​
Available Scripts

CommandDescription
bun run devDevelopment with hot reload
bun run startProduction server
bun run testRun all tests
bun run test:watchWatch mode
bun run lintESLint check
bun run typecheckTypeScript check

​
Docker (Optional)

# Build image
docker build -t bun-core .

# Run container
docker run -p 3100:3100 \
  -e MONGODB_URL=mongodb://host.docker.internal:27017/clawui \
  bun-core

​
Next Steps