Skip to main content

Setup

Prerequisites​

  • NVIDIA DGX Spark (or any machine with an NVIDIA GPU)
  • Python 3.12+ with uv
  • Bun 1.3+
  • Docker and Docker Compose (for production deployment)

Development​

Install dependencies​

# Backend
cd backend
uv sync

# Frontend
cd frontend
bun install

Run locally​

From the project root:

make dev

This starts both the backend (port 8000) and frontend (port 3000). The frontend proxies /api/* requests to the backend automatically.

Access the app​

Open http://localhost:3000 in a browser on the DGX Spark.

Production (Docker)​

Build and start​

make build
make up

nginx serves the app on port 80, proxying to the frontend and backend containers.

Stop​

make down

Rebuild after code changes​

make rebuild

View logs​

make logs