Build

Contributor docs — how to set up the dev environment, run from source, and ship a release build.

Dev environment →   clone, GStreamer.framework prerequisites, uv venv, install extras, common gotchas (miniforge dylibs, PKG_CONFIG_PATH).

Submodules & vendoring →   the vendor/ocap-macos, vendor/ocap-windows, and vendor/open-world-agents-private submodules; what each provides and how to keep them in sync.

Cross-platform rule →   Cue runs on macOS and Windows. The PR checklist and the discipline that keeps both platforms in sync.

Release builds →   Nuitka + Developer ID + notarization (macOS), PyInstaller + Inno Setup (Windows). The bundled llama-server binary, hardened runtime entitlements, the Apple notary submission flow.

Eval & smoke →   cue.eval.digest_eval — the local-vs-cloud digest harness that gates the on-device default flip; how to run it, where the fixtures live, how to read the JSON output.