@camstack/addon-vision 0.1.0 → 0.1.1

package/dist/addons/face-detection/index.js

@@ -35,8 +35,417 @@ __export(face_detection_exports, {
 module.exports = __toCommonJS(face_detection_exports);
 
 // src/catalogs/face-detection-models.ts
+var import_types2 = require("@camstack/types");
+
+// src/catalogs/object-detection-models.ts
 var import_types = require("@camstack/types");
 var HF_REPO = "camstack/camstack-models";
+var MLPACKAGE_FILES = [
+  "Manifest.json",
+  "Data/com.apple.CoreML/model.mlmodel",
+  "Data/com.apple.CoreML/weights/weight.bin"
+];
+var OBJECT_DETECTION_MODELS = [
+  // ── YOLOv8 ──────────────────────────────────────────────────────
+  {
+    id: "yolov8n",
+    name: "YOLOv8 Nano",
+    description: "YOLOv8 Nano \u2014 fastest, smallest object detection model",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/onnx/camstack-yolov8n.onnx"),
+        sizeMB: 12
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/coreml/camstack-yolov8n.mlpackage"),
+        sizeMB: 6,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/openvino/camstack-yolov8n.xml"),
+        sizeMB: 7,
+        runtimes: ["python"]
+      },
+      tflite: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/tflite/camstack-yolov8n_float32.tflite"),
+        sizeMB: 12,
+        runtimes: ["python"]
+      }
+    }
+  },
+  {
+    id: "yolov8s",
+    name: "YOLOv8 Small",
+    description: "YOLOv8 Small \u2014 balanced speed and accuracy",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/onnx/camstack-yolov8s.onnx"),
+        sizeMB: 43
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/coreml/camstack-yolov8s.mlpackage"),
+        sizeMB: 21,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/openvino/camstack-yolov8s.xml"),
+        sizeMB: 22,
+        runtimes: ["python"]
+      },
+      tflite: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/tflite/camstack-yolov8s_float32.tflite"),
+        sizeMB: 43,
+        runtimes: ["python"]
+      }
+    }
+  },
+  {
+    id: "yolov8s-relu",
+    name: "YOLOv8 Small ReLU",
+    description: "YOLOv8 Small with ReLU activation \u2014 better hardware compatibility",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/onnx/camstack-yolov8s-relu.onnx"),
+        sizeMB: 43
+      }
+    }
+  },
+  {
+    id: "yolov8m",
+    name: "YOLOv8 Medium",
+    description: "YOLOv8 Medium \u2014 higher accuracy, moderate size",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/onnx/camstack-yolov8m.onnx"),
+        sizeMB: 99
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/coreml/camstack-yolov8m.mlpackage"),
+        sizeMB: 49,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/openvino/camstack-yolov8m.xml"),
+        sizeMB: 50,
+        runtimes: ["python"]
+      },
+      tflite: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/tflite/camstack-yolov8m_float32.tflite"),
+        sizeMB: 99,
+        runtimes: ["python"]
+      }
+    }
+  },
+  {
+    id: "yolov8l",
+    name: "YOLOv8 Large",
+    description: "YOLOv8 Large \u2014 high-accuracy large model",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/onnx/camstack-yolov8l.onnx"),
+        sizeMB: 167
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/coreml/camstack-yolov8l.mlpackage"),
+        sizeMB: 83,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/openvino/camstack-yolov8l.xml"),
+        sizeMB: 84,
+        runtimes: ["python"]
+      }
+    }
+  },
+  {
+    id: "yolov8x",
+    name: "YOLOv8 Extra-Large",
+    description: "YOLOv8 Extra-Large \u2014 maximum accuracy",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/onnx/camstack-yolov8x.onnx"),
+        sizeMB: 260
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/coreml/camstack-yolov8x.mlpackage"),
+        sizeMB: 130,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov8/openvino/camstack-yolov8x.xml"),
+        sizeMB: 131,
+        runtimes: ["python"]
+      }
+    }
+  },
+  // ── YOLOv9 ──────────────────────────────────────────────────────
+  {
+    id: "yolov9t",
+    name: "YOLOv9 Tiny",
+    description: "YOLOv9 Tiny \u2014 ultra-lightweight next-gen detector",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/onnx/camstack-yolov9t.onnx"),
+        sizeMB: 8
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/coreml/camstack-yolov9t.mlpackage"),
+        sizeMB: 4,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/openvino/camstack-yolov9t.xml"),
+        sizeMB: 6,
+        runtimes: ["python"]
+      },
+      tflite: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/tflite/camstack-yolov9t_float32.tflite"),
+        sizeMB: 8,
+        runtimes: ["python"]
+      }
+    }
+  },
+  {
+    id: "yolov9s",
+    name: "YOLOv9 Small",
+    description: "YOLOv9 Small \u2014 improved efficiency over YOLOv8s",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/onnx/camstack-yolov9s.onnx"),
+        sizeMB: 28
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/coreml/camstack-yolov9s.mlpackage"),
+        sizeMB: 14,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/openvino/camstack-yolov9s.xml"),
+        sizeMB: 16,
+        runtimes: ["python"]
+      },
+      tflite: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/tflite/camstack-yolov9s_float32.tflite"),
+        sizeMB: 28,
+        runtimes: ["python"]
+      }
+    }
+  },
+  {
+    id: "yolov9c",
+    name: "YOLOv9 C",
+    description: "YOLOv9 C \u2014 high-accuracy compact model",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/onnx/camstack-yolov9c.onnx"),
+        sizeMB: 97
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/coreml/camstack-yolov9c.mlpackage"),
+        sizeMB: 48,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/openvino/camstack-yolov9c.xml"),
+        sizeMB: 49,
+        runtimes: ["python"]
+      },
+      tflite: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolov9/tflite/camstack-yolov9c_float32.tflite"),
+        sizeMB: 97,
+        runtimes: ["python"]
+      }
+    }
+  },
+  // ── YOLO11 ────────────────────────────────────────────────────
+  {
+    id: "yolo11n",
+    name: "YOLO11 Nano",
+    description: "YOLO11 Nano \u2014 fastest, smallest YOLO11 detection model (mAP 39.5)",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/onnx/camstack-yolo11n.onnx"),
+        sizeMB: 10
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/coreml/camstack-yolo11n.mlpackage"),
+        sizeMB: 5,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/openvino/camstack-yolo11n.xml"),
+        sizeMB: 5,
+        runtimes: ["python"]
+      },
+      tflite: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/tflite/camstack-yolo11n_float32.tflite"),
+        sizeMB: 10,
+        runtimes: ["python"]
+      }
+    }
+  },
+  {
+    id: "yolo11s",
+    name: "YOLO11 Small",
+    description: "YOLO11 Small \u2014 balanced speed and accuracy (mAP 47.0)",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/onnx/camstack-yolo11s.onnx"),
+        sizeMB: 36
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/coreml/camstack-yolo11s.mlpackage"),
+        sizeMB: 18,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/openvino/camstack-yolo11s.xml"),
+        sizeMB: 18,
+        runtimes: ["python"]
+      },
+      tflite: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/tflite/camstack-yolo11s_float32.tflite"),
+        sizeMB: 36,
+        runtimes: ["python"]
+      }
+    }
+  },
+  {
+    id: "yolo11m",
+    name: "YOLO11 Medium",
+    description: "YOLO11 Medium \u2014 higher accuracy, moderate size (mAP 51.5)",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/onnx/camstack-yolo11m.onnx"),
+        sizeMB: 77
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/coreml/camstack-yolo11m.mlpackage"),
+        sizeMB: 39,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/openvino/camstack-yolo11m.xml"),
+        sizeMB: 39,
+        runtimes: ["python"]
+      },
+      tflite: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/tflite/camstack-yolo11m_float32.tflite"),
+        sizeMB: 77,
+        runtimes: ["python"]
+      }
+    }
+  },
+  {
+    id: "yolo11l",
+    name: "YOLO11 Large",
+    description: "YOLO11 Large \u2014 high-accuracy large model (mAP 53.4)",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/onnx/camstack-yolo11l.onnx"),
+        sizeMB: 97
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/coreml/camstack-yolo11l.mlpackage"),
+        sizeMB: 49,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/openvino/camstack-yolo11l.xml"),
+        sizeMB: 49,
+        runtimes: ["python"]
+      },
+      tflite: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/tflite/camstack-yolo11l_float32.tflite"),
+        sizeMB: 97,
+        runtimes: ["python"]
+      }
+    }
+  },
+  {
+    id: "yolo11x",
+    name: "YOLO11 Extra-Large",
+    description: "YOLO11 Extra-Large \u2014 maximum accuracy (mAP 54.7)",
+    inputSize: { width: 640, height: 640 },
+    labels: import_types.COCO_80_LABELS,
+    formats: {
+      onnx: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/onnx/camstack-yolo11x.onnx"),
+        sizeMB: 218
+      },
+      coreml: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/coreml/camstack-yolo11x.mlpackage"),
+        sizeMB: 109,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
+      },
+      openvino: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/openvino/camstack-yolo11x.xml"),
+        sizeMB: 109,
+        runtimes: ["python"]
+      },
+      tflite: {
+        url: (0, import_types.hfModelUrl)(HF_REPO, "objectDetection/yolo11/tflite/camstack-yolo11x_float32.tflite"),
+        sizeMB: 218,
+        runtimes: ["python"]
+      }
+    }
+  }
+];
+
+// src/catalogs/face-detection-models.ts
+var HF_REPO2 = "camstack/camstack-models";
 var FACE_LABELS = [
   { id: "face", name: "Face" }
 ];
@@ -49,16 +458,20 @@ var FACE_DETECTION_MODELS = [
     labels: FACE_LABELS,
     formats: {
       onnx: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceDetection/scrfd/onnx/camstack-scrfd-500m.onnx"),
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceDetection/scrfd/onnx/camstack-scrfd-500m.onnx"),
         sizeMB: 2.2
       },
       coreml: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceDetection/scrfd/coreml/camstack-scrfd-500m.mlpackage"),
-        sizeMB: 1.2
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceDetection/scrfd/coreml/camstack-scrfd-500m.mlpackage"),
+        sizeMB: 1.2,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
       },
       openvino: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceDetection/scrfd/openvino/camstack-scrfd-500m.xml"),
-        sizeMB: 1.3
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceDetection/scrfd/openvino/camstack-scrfd-500m.xml"),
+        sizeMB: 1.3,
+        runtimes: ["python"]
       }
     }
   },
@@ -70,16 +483,20 @@ var FACE_DETECTION_MODELS = [
     labels: FACE_LABELS,
     formats: {
       onnx: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceDetection/scrfd/onnx/camstack-scrfd-2.5g.onnx"),
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceDetection/scrfd/onnx/camstack-scrfd-2.5g.onnx"),
         sizeMB: 3.1
       },
       coreml: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceDetection/scrfd/coreml/camstack-scrfd-2.5g.mlpackage"),
-        sizeMB: 1.7
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceDetection/scrfd/coreml/camstack-scrfd-2.5g.mlpackage"),
+        sizeMB: 1.7,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
       },
       openvino: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceDetection/scrfd/openvino/camstack-scrfd-2.5g.xml"),
-        sizeMB: 1.8
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceDetection/scrfd/openvino/camstack-scrfd-2.5g.xml"),
+        sizeMB: 1.8,
+        runtimes: ["python"]
       }
     }
   },
@@ -91,16 +508,20 @@ var FACE_DETECTION_MODELS = [
     labels: FACE_LABELS,
     formats: {
       onnx: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceDetection/scrfd/onnx/camstack-scrfd-10g.onnx"),
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceDetection/scrfd/onnx/camstack-scrfd-10g.onnx"),
         sizeMB: 16
       },
       coreml: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceDetection/scrfd/coreml/camstack-scrfd-10g.mlpackage"),
-        sizeMB: 8.2
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceDetection/scrfd/coreml/camstack-scrfd-10g.mlpackage"),
+        sizeMB: 8.2,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
       },
       openvino: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceDetection/scrfd/openvino/camstack-scrfd-10g.xml"),
-        sizeMB: 8.3
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceDetection/scrfd/openvino/camstack-scrfd-10g.xml"),
+        sizeMB: 8.3,
+        runtimes: ["python"]
       }
     }
   }
@@ -331,6 +752,7 @@ var NodeInferenceEngine = class {
 
 // src/shared/python-engine.ts
 var import_node_child_process = require("child_process");
+var import_core = require("@camstack/core");
 var PythonInferenceEngine = class {
   constructor(pythonPath, scriptPath, runtime, modelPath, extraArgs = []) {
     this.pythonPath = pythonPath;
@@ -451,7 +873,7 @@ var PythonInferenceEngine = class {
 var AUTO_BACKEND_PRIORITY = ["coreml", "cuda", "tensorrt", "cpu"];
 var BACKEND_TO_FORMAT = {
   cpu: "onnx",
-  coreml: "coreml",
+  coreml: "onnx",
   cuda: "onnx",
   tensorrt: "onnx"
 };
@@ -479,7 +901,7 @@ function modelExists(filePath) {
   }
 }
 async function resolveEngine(options) {
-  const { runtime, backend, modelEntry, modelsDir, downloadModel } = options;
+  const { runtime, backend, modelEntry, modelsDir, models } = options;
   let selectedFormat;
   let selectedBackend;
   if (runtime === "auto") {
@@ -513,18 +935,18 @@ async function resolveEngine(options) {
     selectedFormat = fmt;
     selectedBackend = runtime === "onnx" ? backend || "cpu" : runtime;
   }
-  let modelPath = modelFilePath(modelsDir, modelEntry, selectedFormat);
-  if (!modelExists(modelPath)) {
-    if (downloadModel) {
-      const formatEntry = modelEntry.formats[selectedFormat];
-      modelPath = await downloadModel(formatEntry.url, modelsDir);
-    } else {
+  let modelPath;
+  if (models) {
+    modelPath = await models.ensure(modelEntry.id, selectedFormat);
+  } else {
+    modelPath = modelFilePath(modelsDir, modelEntry, selectedFormat);
+    if (!modelExists(modelPath)) {
       throw new Error(
-        `resolveEngine: model file not found at ${modelPath} and no downloadModel function provided`
+        `resolveEngine: model file not found at ${modelPath} and no model service provided`
       );
     }
   }
-  if (selectedFormat === "onnx" || selectedFormat === "coreml") {
+  if (selectedFormat === "onnx") {
     const engine = new NodeInferenceEngine(modelPath, selectedBackend);
     await engine.initialize();
     return { engine, format: selectedFormat, modelPath };
@@ -538,7 +960,18 @@ async function resolveEngine(options) {
   const effectiveRuntime = runtime === "auto" ? selectedBackend : runtime;
   const scriptName = PYTHON_SCRIPT_MAP[effectiveRuntime];
   if (scriptName && pythonPath) {
-    const scriptPath = path2.join(__dirname, "../../python", scriptName);
+    const candidates = [
+      path2.join(__dirname, "../../python", scriptName),
+      path2.join(__dirname, "../python", scriptName),
+      path2.join(__dirname, "../../../python", scriptName)
+    ];
+    const scriptPath = candidates.find((p) => fs.existsSync(p));
+    if (!scriptPath) {
+      throw new Error(
+        `resolveEngine: Python script "${scriptName}" not found. Searched:
+${candidates.join("\n")}`
+      );
+    }
     const inputSize = Math.max(modelEntry.inputSize.width, modelEntry.inputSize.height);
     const engine = new PythonInferenceEngine(pythonPath, scriptPath, effectiveRuntime, modelPath, [
       `--input-size=${inputSize}`,
@@ -580,6 +1013,16 @@ async function probeOnnxBackends() {
 var FACE_LABEL = { id: "face", name: "Face" };
 var FACE_LABELS2 = [FACE_LABEL];
 var FACE_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+var RAM_ESTIMATES = {
+  "scrfd-500m": 50,
+  "scrfd-2.5g": 80,
+  "scrfd-10g": 200
+};
+var ACCURACY_SCORES = {
+  "scrfd-500m": 70,
+  "scrfd-2.5g": 82,
+  "scrfd-10g": 92
+};
 var FaceDetectionAddon = class {
   id = "face-detection";
   slot = "cropper";
@@ -591,7 +1034,6 @@ var FaceDetectionAddon = class {
     name: "Face Detection",
     version: "0.1.0",
     description: "SCRFD-based face detector \u2014 crops face regions from person detections",
-    packageName: "@camstack/addon-vision",
     slot: "cropper",
     inputClasses: ["person"],
     outputClasses: ["face"],
@@ -599,34 +1041,41 @@ var FaceDetectionAddon = class {
     mayRequirePython: false,
     defaultConfig: {
       modelId: "scrfd-500m",
-      runtime: "auto",
+      runtime: "node",
       backend: "cpu",
       confidence: 0.5
     }
   };
-  engine;
+  engine = null;
   modelEntry;
   confidence = 0.5;
+  resolvedConfig = null;
+  ctx = null;
+  getModelRequirements() {
+    return FACE_DETECTION_MODELS.map((m) => ({
+      modelId: m.id,
+      name: m.name,
+      minRAM_MB: RAM_ESTIMATES[m.id] ?? 50,
+      accuracyScore: ACCURACY_SCORES[m.id] ?? 70,
+      formats: Object.keys(m.formats)
+    }));
+  }
+  configure(config) {
+    this.resolvedConfig = config;
+  }
   async initialize(ctx) {
+    this.ctx = ctx;
     const cfg = ctx.addonConfig;
-    const modelId = cfg["modelId"] ?? "scrfd-500m";
-    const runtime = cfg["runtime"] ?? "auto";
-    const backend = cfg["backend"] ?? "cpu";
+    const modelId = cfg["modelId"] ?? this.resolvedConfig?.modelId ?? "scrfd-500m";
     this.confidence = cfg["confidence"] ?? 0.5;
     const entry = FACE_DETECTION_MODELS.find((m) => m.id === modelId);
     if (!entry) {
       throw new Error(`FaceDetectionAddon: unknown modelId "${modelId}"`);
     }
     this.modelEntry = entry;
-    const resolved = await resolveEngine({
-      runtime,
-      backend,
-      modelEntry: entry,
-      modelsDir: ctx.locationPaths.models
-    });
-    this.engine = resolved.engine;
   }
   async crop(input) {
+    if (!this.engine) await this.ensureEngine();
     const start = Date.now();
     const { width: inputW, height: inputH } = this.modelEntry.inputSize;
     const targetSize = Math.max(inputW, inputH);
@@ -653,6 +1102,27 @@ var FaceDetectionAddon = class {
       modelId: this.modelEntry.id
     };
   }
+  async ensureEngine() {
+    const config = this.resolvedConfig;
+    const modelId = config?.modelId ?? this.modelEntry.id;
+    const runtime = config?.runtime === "python" ? "coreml" : config?.runtime === "node" ? "onnx" : "auto";
+    const backend = config?.backend ?? "cpu";
+    const format = config?.format ?? "onnx";
+    const entry = FACE_DETECTION_MODELS.find((m) => m.id === modelId) ?? this.modelEntry;
+    this.modelEntry = entry;
+    const modelsDir = this.ctx.models?.getModelsDir() ?? this.ctx.locationPaths.models;
+    if (this.ctx.models) {
+      await this.ctx.models.ensure(modelId, format);
+    }
+    const resolved = await resolveEngine({
+      runtime,
+      backend,
+      modelEntry: entry,
+      modelsDir,
+      models: this.ctx.models
+    });
+    this.engine = resolved.engine;
+  }
   async shutdown() {
     await this.engine?.dispose();
   }
@@ -677,6 +1147,36 @@ var FaceDetectionAddon = class {
             }
           ]
         },
+        {
+          id: "runtime",
+          title: "Runtime",
+          columns: 2,
+          fields: [
+            {
+              key: "runtime",
+              label: "Runtime",
+              type: "select",
+              options: [
+                { value: "auto", label: "Auto" },
+                { value: "onnx", label: "ONNX Runtime" },
+                { value: "coreml", label: "CoreML (Apple)" },
+                { value: "openvino", label: "OpenVINO (Intel)" }
+              ]
+            },
+            {
+              key: "backend",
+              label: "Backend",
+              type: "select",
+              showWhen: { field: "runtime", equals: "onnx" },
+              options: [
+                { value: "auto", label: "Auto" },
+                { value: "cpu", label: "CPU" },
+                { value: "coreml", label: "CoreML" },
+                { value: "cuda", label: "CUDA (NVIDIA)" }
+              ]
+            }
+          ]
+        },
         {
           id: "thresholds",
           title: "Detection Thresholds",