Add reusable GIS run mode and AI runtime opt-in

deploy/unraid/Dockerfile.all-in-one

@@ -8,6 +8,8 @@ RUN npm run build
 
 FROM postgres:16-bookworm AS runtime
 
+ARG GEOINTEL_INSTALL_AI=false
+
 ENV GEOINTEL_ENV=production \
     GEOINTEL_API_PREFIX=/api/v1 \
     GEOINTEL_STORAGE_ROOT=/app/storage \
@@ -43,8 +45,11 @@ COPY --from=frontend-build /frontend/dist/ /usr/share/nginx/html/
 
 RUN /usr/bin/python3.11 -m venv /opt/geointel/venv \
     && pip install --no-cache-dir --upgrade pip setuptools \
-    && pip install --no-cache-dir ".[gis]" \
+    && extras=".[gis]" \
+    && if [ "$GEOINTEL_INSTALL_AI" = "true" ]; then extras=".[gis,ai]"; fi \
+    && pip install --no-cache-dir "$extras" \
     && python scripts/gis_import_smoke.py \
+    && python scripts/yolo_preflight.py --json >/tmp/geointel-yolo-preflight.json \
     && chmod +x /usr/local/bin/geointel-all-in-one-start \
     && rm -f /etc/nginx/sites-enabled/default \
     && mkdir -p /app/storage /run/nginx /var/log/nginx

deploy/unraid/README.md

@@ -72,16 +72,21 @@ cd /mnt/user/appdata/geointel
 cp deploy/unraid/geointel.env.example .env
 nano .env
 docker compose -f docker-compose.unraid.yml config
-docker build -f deploy/unraid/Dockerfile.all-in-one -t geointel-all-in-one:latest .
+docker build --build-arg GEOINTEL_INSTALL_AI=${GEOINTEL_INSTALL_AI:-false} -f deploy/unraid/Dockerfile.all-in-one -t geointel-all-in-one:latest .
 bash deploy/unraid/run-dockerman-container.sh
 ```
 
-The repository deploy scripts run the same flow automatically. They validate the Compose reference, build the image with plain `docker build`, install the DockerMan template/icon, remove any old Compose-owned `geointel` container, preserve/migrate the PostGIS data path and start the final container with DockerMan labels.
+The repository deploy scripts run the same flow automatically. They validate the Compose reference, build the image with the `GEOINTEL_INSTALL_AI` build arg, install the DockerMan template/icon, remove any old Compose-owned `geointel` container, preserve/migrate the PostGIS data path and start the final container with DockerMan labels.
 
 Database credentials are runtime configuration, not image metadata. The
 all-in-one image does not bake `GEOINTEL_POSTGRES_PASSWORD` into the Dockerfile;
 set it through `.env`, the Unraid template or `docker run -e`.
 
+AI dependencies are opt-in. Leave `GEOINTEL_INSTALL_AI=false` for the default
+GIS-only image. Set `GEOINTEL_INSTALL_AI=true`, mount models through
+`GEOINTEL_MODELS_PATH` and configure `YOLO_ENABLED=true` plus
+`YOLO_MODEL_PATH=/app/models/<model>.pt` only when you have a local model file.
+
 Validate:
 
 ```bash
@@ -119,7 +124,7 @@ GEOINTEL_CORS_ORIGINS=http://localhost:1203,http://127.0.0.1:1203,http://192.168
 Apply:
 
 ```bash
-docker build -f deploy/unraid/Dockerfile.all-in-one -t geointel-all-in-one:latest .
+docker build --build-arg GEOINTEL_INSTALL_AI=${GEOINTEL_INSTALL_AI:-false} -f deploy/unraid/Dockerfile.all-in-one -t geointel-all-in-one:latest .
 bash deploy/unraid/run-dockerman-container.sh
 ```
 
@@ -142,7 +147,7 @@ GEOINTEL_POSTGIS_DATA_PATH=/mnt/user/appdata/geointel/postgres-data
 cd /mnt/user/appdata/geointel
 git fetch origin main
 git reset --hard origin/main
-docker build -f deploy/unraid/Dockerfile.all-in-one -t geointel-all-in-one:latest .
+docker build --build-arg GEOINTEL_INSTALL_AI=${GEOINTEL_INSTALL_AI:-false} -f deploy/unraid/Dockerfile.all-in-one -t geointel-all-in-one:latest .
 bash deploy/unraid/run-dockerman-container.sh
 ```
 

deploy/unraid/geointel.env.example

@@ -7,6 +7,9 @@ GEOINTEL_FRONTEND_PORT=1202
 # Persisted application artifacts: uploads, tiles, masks, reports and exports.
 GEOINTEL_STORAGE_PATH=/mnt/user/appdata/geointel/storage
 
+# Local AI model files mounted into the container as /app/models.
+GEOINTEL_MODELS_PATH=/mnt/user/appdata/geointel/models
+
 # Embedded PostGIS data directory for the all-in-one container.
 GEOINTEL_POSTGIS_DATA_PATH=/mnt/user/appdata/geointel/postgres-data
 
@@ -20,3 +23,15 @@ GEOINTEL_CORS_ORIGINS=http://localhost:1202,http://127.0.0.1:1202,http://192.168
 
 # Upload guard in MiB.
 GEOINTEL_MAX_UPLOAD_MB=500
+
+# Optional configured-YOLO runtime. Keep disabled unless a local model is mounted.
+GEOINTEL_INSTALL_AI=false
+YOLO_ENABLED=false
+YOLO_MODEL_PATH=
+YOLO_MODEL_ID=yolo-configured
+YOLO_MODEL_DISPLAY_NAME=Configured YOLO detector
+YOLO_MODEL_VERSION=
+YOLO_DEVICE=cpu
+YOLO_IMAGE_SIZE=640
+YOLO_MAX_TILES=100
+YOLO_BATCH_SIZE=1

deploy/unraid/run-dockerman-container.sh

@@ -13,12 +13,22 @@ fi
 
 GEOINTEL_FRONTEND_PORT="${GEOINTEL_FRONTEND_PORT:-1202}"
 GEOINTEL_STORAGE_PATH="${GEOINTEL_STORAGE_PATH:-/mnt/user/appdata/geointel/storage}"
+GEOINTEL_MODELS_PATH="${GEOINTEL_MODELS_PATH:-/mnt/user/appdata/geointel/models}"
 GEOINTEL_POSTGIS_DATA_PATH="${GEOINTEL_POSTGIS_DATA_PATH:-/mnt/user/appdata/geointel/postgres-data}"
 GEOINTEL_POSTGRES_DB="${GEOINTEL_POSTGRES_DB:-geointel}"
 GEOINTEL_POSTGRES_USER="${GEOINTEL_POSTGRES_USER:-geointel}"
 GEOINTEL_POSTGRES_PASSWORD="${GEOINTEL_POSTGRES_PASSWORD:-geointel}"
 GEOINTEL_CORS_ORIGINS="${GEOINTEL_CORS_ORIGINS:-http://localhost:${GEOINTEL_FRONTEND_PORT},http://127.0.0.1:${GEOINTEL_FRONTEND_PORT},http://192.168.10.150:${GEOINTEL_FRONTEND_PORT}}"
 GEOINTEL_MAX_UPLOAD_MB="${GEOINTEL_MAX_UPLOAD_MB:-500}"
+YOLO_ENABLED="${YOLO_ENABLED:-false}"
+YOLO_MODEL_PATH="${YOLO_MODEL_PATH:-}"
+YOLO_MODEL_ID="${YOLO_MODEL_ID:-yolo-configured}"
+YOLO_MODEL_DISPLAY_NAME="${YOLO_MODEL_DISPLAY_NAME:-Configured YOLO detector}"
+YOLO_MODEL_VERSION="${YOLO_MODEL_VERSION:-}"
+YOLO_DEVICE="${YOLO_DEVICE:-cpu}"
+YOLO_IMAGE_SIZE="${YOLO_IMAGE_SIZE:-640}"
+YOLO_MAX_TILES="${YOLO_MAX_TILES:-100}"
+YOLO_BATCH_SIZE="${YOLO_BATCH_SIZE:-1}"
 
 install_dockerman_metadata() {
   if [ -d /boot/config/plugins/dockerMan ]; then
@@ -52,7 +62,7 @@ if docker ps -a --format '{{.Names}}' | grep -qx geointel; then
   docker rm -f geointel
 fi
 
-mkdir -p "$GEOINTEL_STORAGE_PATH" "$GEOINTEL_POSTGIS_DATA_PATH"
+mkdir -p "$GEOINTEL_STORAGE_PATH" "$GEOINTEL_MODELS_PATH" "$GEOINTEL_POSTGIS_DATA_PATH"
 migrate_compose_volume_if_needed
 
 docker run -d \
@@ -68,8 +78,18 @@ docker run -d \
   -e GEOINTEL_STORAGE_ROOT=/app/storage \
   -e GEOINTEL_CORS_ORIGINS="$GEOINTEL_CORS_ORIGINS" \
   -e GEOINTEL_MAX_UPLOAD_MB="$GEOINTEL_MAX_UPLOAD_MB" \
+  -e YOLO_ENABLED="$YOLO_ENABLED" \
+  -e YOLO_MODEL_PATH="$YOLO_MODEL_PATH" \
+  -e YOLO_MODEL_ID="$YOLO_MODEL_ID" \
+  -e YOLO_MODEL_DISPLAY_NAME="$YOLO_MODEL_DISPLAY_NAME" \
+  -e YOLO_MODEL_VERSION="$YOLO_MODEL_VERSION" \
+  -e YOLO_DEVICE="$YOLO_DEVICE" \
+  -e YOLO_IMAGE_SIZE="$YOLO_IMAGE_SIZE" \
+  -e YOLO_MAX_TILES="$YOLO_MAX_TILES" \
+  -e YOLO_BATCH_SIZE="$YOLO_BATCH_SIZE" \
   -v "${GEOINTEL_POSTGIS_DATA_PATH}:/var/lib/postgresql/data" \
   -v "${GEOINTEL_STORAGE_PATH}:/app/storage" \
+  -v "${GEOINTEL_MODELS_PATH}:/app/models" \
   geointel-all-in-one:latest
 
 docker ps --filter name=geointel