@camstack/addon-vision 0.1.0 → 0.1.1

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

@@ -35,8 +35,417 @@ __export(face_recognition_exports, {
 module.exports = __toCommonJS(face_recognition_exports);
 
 // src/catalogs/face-recognition-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-recognition-models.ts
+var HF_REPO2 = "camstack/camstack-models";
 var FACE_EMBEDDING_LABELS = [
   { id: "embedding", name: "Face Embedding" }
 ];
@@ -50,16 +459,20 @@ var FACE_RECOGNITION_MODELS = [
     labels: FACE_EMBEDDING_LABELS,
     formats: {
       onnx: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceRecognition/arcface/onnx/camstack-arcface-arcface.onnx"),
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceRecognition/arcface/onnx/camstack-arcface-arcface.onnx"),
         sizeMB: 130
       },
       coreml: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceRecognition/arcface/coreml/camstack-arcface-r100.mlpackage"),
-        sizeMB: 65
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceRecognition/arcface/coreml/camstack-arcface-r100.mlpackage"),
+        sizeMB: 65,
+        isDirectory: true,
+        files: MLPACKAGE_FILES,
+        runtimes: ["python"]
       },
       openvino: {
-        url: (0, import_types.hfModelUrl)(HF_REPO, "faceRecognition/arcface/openvino/camstack-arcface-r100.xml"),
-        sizeMB: 65
+        url: (0, import_types2.hfModelUrl)(HF_REPO2, "faceRecognition/arcface/openvino/camstack-arcface-r100.xml"),
+        sizeMB: 65,
+        runtimes: ["python"]
       }
     }
   }
@@ -76,7 +489,7 @@ async function cropRegion(jpeg, roi) {
   }).jpeg().toBuffer();
 }
 async function resizeAndNormalize(jpeg, targetWidth, targetHeight, normalization, layout) {
-  const { data } = await (0, import_sharp.default)(jpeg).resize(targetWidth, targetHeight).removeAlpha().raw().toBuffer({ resolveWithObject: true });
+  const { data } = await (0, import_sharp.default)(jpeg).resize(targetWidth, targetHeight, { fit: "fill" }).removeAlpha().raw().toBuffer({ resolveWithObject: true });
   const numPixels = targetWidth * targetHeight;
   const float32 = new Float32Array(3 * numPixels);
   const mean = [0.485, 0.456, 0.406];
@@ -206,6 +619,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;
@@ -326,7 +740,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"
 };
@@ -354,7 +768,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") {
@@ -388,18 +802,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 };
@@ -413,7 +827,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}`,
@@ -470,8 +895,8 @@ var FaceRecognitionAddon = class {
     name: "Face Recognition",
     version: "0.1.0",
     description: "ArcFace-based face recognition \u2014 produces 512-d identity embeddings",
-    packageName: "@camstack/addon-vision",
     slot: "classifier",
+    labelOutputType: "face",
     inputClasses: ["face"],
     outputClasses: ["identity:*"],
     requiredSteps: REQUIRED_STEPS,
@@ -479,31 +904,38 @@ var FaceRecognitionAddon = class {
     mayRequirePython: false,
     defaultConfig: {
       modelId: "arcface-r100",
-      runtime: "auto",
+      runtime: "node",
       backend: "cpu"
     }
   };
-  engine;
+  engine = null;
   modelEntry;
+  resolvedConfig = null;
+  ctx = null;
+  getModelRequirements() {
+    return FACE_RECOGNITION_MODELS.map((m) => ({
+      modelId: m.id,
+      name: m.name,
+      minRAM_MB: 400,
+      accuracyScore: 90,
+      formats: Object.keys(m.formats)
+    }));
+  }
+  configure(config) {
+    this.resolvedConfig = config;
+  }
   async initialize(ctx) {
+    this.ctx = ctx;
     const cfg = ctx.addonConfig;
-    const modelId = cfg["modelId"] ?? "arcface-r100";
-    const runtime = cfg["runtime"] ?? "auto";
-    const backend = cfg["backend"] ?? "cpu";
+    const modelId = cfg["modelId"] ?? this.resolvedConfig?.modelId ?? "arcface-r100";
     const entry = FACE_RECOGNITION_MODELS.find((m) => m.id === modelId);
     if (!entry) {
       throw new Error(`FaceRecognitionAddon: unknown modelId "${modelId}"`);
     }
     this.modelEntry = entry;
-    const resolved = await resolveEngine({
-      runtime,
-      backend,
-      modelEntry: entry,
-      modelsDir: ctx.locationPaths.models
-    });
-    this.engine = resolved.engine;
   }
   async classify(input) {
+    if (!this.engine) await this.ensureEngine();
     const start = Date.now();
     const { width: inputW, height: inputH } = this.modelEntry.inputSize;
     const faceCrop = await cropRegion(input.frame.data, input.roi);
@@ -524,6 +956,27 @@ var FaceRecognitionAddon = 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_RECOGNITION_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();
   }
@@ -558,17 +1011,19 @@ var FaceRecognitionAddon = class {
               label: "Runtime",
               type: "select",
               options: [
-                { value: "auto", label: "Auto (recommended)" },
+                { value: "auto", label: "Auto" },
                 { value: "onnx", label: "ONNX Runtime" },
-                { value: "coreml", label: "CoreML (Apple)" }
+                { value: "coreml", label: "CoreML (Apple)" },
+                { value: "openvino", label: "OpenVINO (Intel)" }
               ]
             },
             {
               key: "backend",
               label: "Backend",
               type: "select",
-              dependsOn: { runtime: "onnx" },
+              showWhen: { field: "runtime", equals: "onnx" },
               options: [
+                { value: "auto", label: "Auto" },
                 { value: "cpu", label: "CPU" },
                 { value: "coreml", label: "CoreML" },
                 { value: "cuda", label: "CUDA (NVIDIA)" }