Add reusable GIS run mode and AI runtime opt-in

backend/README.md

@@ -216,6 +216,17 @@ cd backend
 python -m pip install -e .[ai]
 ```
 
+Docker and Unraid builds keep AI dependencies disabled by default. To build an
+image with local PyTorch/Ultralytics support, set:
+
+```bash
+GEOINTEL_INSTALL_AI=true
+```
+
+The default remains `false` so normal GIS deployments do not install the large AI
+runtime. GeoIntel still requires an explicit local model path and never downloads
+weights automatically.
+
 Configured YOLO requires:
 
 ```bash
@@ -235,6 +246,15 @@ In Docker, run the same smoke through the backend container:
 docker compose exec -T backend python scripts/yolo_preflight.py --model-path /absolute/path/to/local-model.pt --tile-manifest-path /absolute/path/to/manifest.json --check-model-load --json
 ```
 
+In the all-in-one Unraid runtime, place model files under the configured models
+directory, mounted as `/app/models` by default:
+
+```bash
+GEOINTEL_MODELS_PATH=/mnt/user/appdata/geointel/models
+YOLO_ENABLED=true
+YOLO_MODEL_PATH=/app/models/local-model.pt
+```
+
 The smoke loads only the supplied local model file, does not run inference and
 does not download weights.