Add safe YOLO model env configurator

2026-07-06 16:43:53 +02:00
parent c1f81adeea
commit 72ee6233a6
8 changed files with 414 additions and 0 deletions
@@ -91,6 +91,36 @@ libraries needed for Ultralytics imports; it still never downloads model weights
 `YOLO_CONFIG_DIR` defaults to `/app/storage/ultralytics`, a writable persistent
 path, so Ultralytics settings do not fall back to root user config directories.

+To safely configure an existing local YOLO model on Tower, place one supported
+model file (`.pt`, `.onnx` or `.engine`) under:
+
+```text
+/mnt/user/appdata/geointel/models
+```
+
+Then run a dry-run first:
+
+```bash
+cd /mnt/user/appdata/geointel
+python scripts/configure_yolo_model.py \
+  --models-dir /mnt/user/appdata/geointel/models \
+  --env-file .env
+```
+
+Apply only after the selected host and container paths are correct:
+
+```bash
+python scripts/configure_yolo_model.py \
+  --models-dir /mnt/user/appdata/geointel/models \
+  --env-file .env \
+  --apply
+bash deploy/unraid/run-dockerman-container.sh
+```
+
+If multiple model files are present, add `--model-file /mnt/user/appdata/geointel/models/<name>.pt`.
+The helper does not download weights, does not load a model and does not run
+inference; it only updates the env file for the mounted local model.
+
 Validate:

 ```bash