# Building AFFECTOR

The downloaded app is self-contained; building from source is optional. For a rebuild, install Xcode command-line tools, extract the complete app into this source tree as `dist/AFFECTOR.app`, and run `python3 macos/build.py`. The build reuses the relocated runtime and pinned model from that app. Alternatively set AFFECTOR_RUNTIME to an existing complete AFFECTOR.app/Contents/Resources directory. The build outputs an ad-hoc signed development app; this replaces any distribution signature. Follow the Apple release guide to sign/notarize a separate release copy.

Run `PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests` for engine regression tests. A fresh-from-upstream runtime bootstrap is not supplied; requirements-lock.txt records versions but does not perform native-library relocation.