Developer Guide

Developer Guide

Repository Layout

• server/: Python backend, local HTTP server, and ComfyUI bridge.
• frontend/: static browser UI served by the Python backend.
• scripts/: cross-platform Python helpers plus Windows PowerShell wrappers.
• scripts/camera_lab_setup/: modular setup, hardware detection, model/module resolver.
• workflows/app/: checked-in ComfyUI workflows used by Camera Lab.
• workflows/experimental/: optional research workflow references.
• docs/: screenshots, notes, and wiki source pages.
• tests/: Python unit tests and Playwright smoke tests.
• tasks/: local-only generated runs, uploads, logs, and scratch data.

Local Setup For Development

python scripts/agent_setup.py
python scripts/install_workflows.py
python scripts/check_setup.py

Use python3 instead of python where needed.

Python Tests

python -m pytest -p no:cacheprovider -q

Focused launcher tests:

python -m pytest -p no:cacheprovider tests/test_launch.py -q

Browser E2E Tests

Install Node dependencies and Chromium:

npm install
npx playwright install chromium

Run:

npm run test:e2e

Runtime Data

Generated runs and uploaded files are written under:

• tasks/camera_lab_runs/
• tasks/camera_lab_uploads/

tasks/ is ignored by git. Do not put public docs, required workflows, or committable test assets there.

Commit Hygiene

Do not commit:

• .env
• tasks/
• generated videos
• uploads
• logs
• preview renders
• local ComfyUI install paths