This repository supports two practical installation paths:
If you are evaluating the product and want the fastest visible win, start with quickstart.md first.
- Docker Compose for normal use
- Source checkout for contributors
cp .env.example .env
docker compose -f ops/compose/docker-compose.yml up -d --buildRequired values:
OPEN_NOTEBOOK_ENCRYPTION_KEY=change-me-to-a-secret-string
GEMINI_API_KEY=your-google-ai-studio-keyOpen http://localhost:8502.
bash tooling/scripts/runtime/run_uv_managed.sh sync
cd apps/web && npm ci && cd ../..
bash tooling/scripts/runtime/run_uv_managed.sh run --env-file .env python tooling/bin/run_api.pyRun frontend development mode separately:
cd apps/web && npm run devmake test-backend-cov
cd apps/web && npm test && cd ../..If setup still fails, continue with configuration.md and then ../SUPPORT.md.