fix(face-recognition): move engine selection to model gallery, collapse backend entries

The previous commit put engine/model_pack options on backend gallery
entries (`backend/index.yaml`). That was wrong — `GalleryBackend`
(core/gallery/backend_types.go:32) has no `options` field, so the
YAML decoder silently dropped those keys and all three "different
insightface-*" backend entries resolved to the same container image
with no distinguishing configuration.

Correct split:

  * `backend/index.yaml` now has ONE `insightface` backend entry
    shipping the CPU + CUDA 12 container images. The Python backend
    bundles both the non-commercial insightface model packs
    (buffalo_l / buffalo_s) and the commercial-safe OpenCV Zoo
    weights (YuNet + SFace); the active engine is selected at
    LoadModel time via `options: ["engine:..."]`.

  * `gallery/index.yaml` gains three model entries —
    `insightface-buffalo-l`, `insightface-opencv`,
    `insightface-buffalo-s` — each setting the appropriate
    `overrides.backend` + `overrides.options` so installing one
    actually gives the user the intended engine. This matches how
    `rfdetr-base` lives in the model gallery against the `rfdetr`
    backend.

The earlier e2e tests passed despite this bug because the Makefile
targets pass `BACKEND_TEST_OPTIONS` directly to LoadModel via gRPC,
bypassing any gallery resolution entirely. No code changes needed.

Assisted-by: Claude:claude-opus-4-7

Author: mudler

backend/index.yaml

@@ -169,66 +169,40 @@
     nvidia-cuda-12: "cuda12-rfdetr"
     nvidia-l4t-cuda-12: "nvidia-l4t-arm64-rfdetr"
 - &insightface
-  name: "insightface-buffalo-l"
-  alias: "insightface-buffalo-l"
-  # Upstream insightface is MIT but the buffalo_l *weights* are
-  # released for NON-COMMERCIAL research use only.
-  license: "insightface-non-commercial"
+  name: "insightface"
+  alias: "insightface"
+  # Upstream insightface library is MIT. The pretrained model packs
+  # (buffalo_l, buffalo_s, antelopev2) are released for NON-COMMERCIAL
+  # research use only. The backend image also pre-bakes OpenCV Zoo
+  # YuNet + SFace (Apache 2.0) for commercial use. Pick the engine
+  # via model-gallery entries (insightface-buffalo-l / insightface-opencv
+  # / insightface-buffalo-s) or set `options` in your model YAML.
+  license: "mixed"
   description: |
-    Face recognition backend using insightface's buffalo_l model pack
-    (SCRFD-10GF detector + ResNet50 ArcFace embedder + genderage head).
-    Best accuracy among the shipped options. NON-COMMERCIAL RESEARCH USE
-    ONLY — the model weights carry upstream's research-only license.
-    For commercial use see the insightface-opencv entry (Apache 2.0).
-    Weights are pre-baked into the container at build time (~326MB).
+    Face recognition backend powered by `insightface` (ONNX Runtime).
+    Provides face verification (/v1/face/verify), face analysis
+    (/v1/face/analyze), face embedding (/v1/embeddings), face
+    detection (/v1/detection), and 1:N identification
+    (/v1/face/{register,identify,forget}).
+    Ships two engines in a single image: the insightface model packs
+    (buffalo_l, buffalo_s — non-commercial) and the OpenCV Zoo
+    YuNet + SFace pair (Apache 2.0). Select via `options: ["engine:..."]`
+    in your model YAML, or install one of the ready-made model-gallery
+    entries (insightface-buffalo-l / insightface-opencv /
+    insightface-buffalo-s).
   urls:
     - https://github.com/deepinsight/insightface
+    - https://github.com/opencv/opencv_zoo
   tags:
     - face-recognition
     - face-verification
     - face-embedding
-    - research-only
     - gpu
     - cpu
-  options:
-    - "engine:insightface"
-    - "model_pack:buffalo_l"
   capabilities:
     default: "cpu-insightface"
     nvidia: "cuda12-insightface"
     nvidia-cuda-12: "cuda12-insightface"
-- &insightface_opencv
-  !!merge <<: *insightface
-  name: "insightface-opencv"
-  alias: "insightface-opencv"
-  license: "apache-2.0"
-  description: |
-    Face recognition backend using OpenCV Zoo models (YuNet detector +
-    SFace recognizer). APACHE 2.0 — safe for commercial use.
-    Lower accuracy than buffalo_l and no age/gender analysis.
-    Weights (~40MB) are pre-baked inside the backend image.
-  tags:
-    - face-recognition
-    - face-verification
-    - face-embedding
-    - commercial-ok
-    - gpu
-    - cpu
-  options:
-    - "engine:onnx_direct"
-    - "detector_onnx:models/opencv/yunet.onnx"
-    - "recognizer_onnx:models/opencv/sface.onnx"
-- &insightface_buffalo_s
-  !!merge <<: *insightface
-  name: "insightface-buffalo-s"
-  alias: "insightface-buffalo-s"
-  description: |
-    Smaller insightface pack for low-resource deployments (SCRFD-500MF
-    detector + MBF embedder + genderage head). NON-COMMERCIAL RESEARCH
-    USE ONLY. Not pre-baked; downloaded at first use (~159MB).
-  options:
-    - "engine:insightface"
-    - "model_pack:buffalo_s"
 - &sam3cpp
   name: "sam3-cpp"
   alias: "sam3-cpp"
@@ -3782,21 +3756,9 @@
   uri: "quay.io/go-skynet/local-ai-backends:latest-metal-darwin-arm64-llama-cpp-quantization"
   mirrors:
     - localai/localai-backends:latest-metal-darwin-arm64-llama-cpp-quantization
-# insightface (face recognition)
+# insightface (face recognition) — development and concrete image entries
 - !!merge <<: *insightface
-  name: "insightface-buffalo-l-development"
-  capabilities:
-    default: "cpu-insightface-development"
-    nvidia: "cuda12-insightface-development"
-    nvidia-cuda-12: "cuda12-insightface-development"
-- !!merge <<: *insightface_opencv
-  name: "insightface-opencv-development"
-  capabilities:
-    default: "cpu-insightface-development"
-    nvidia: "cuda12-insightface-development"
-    nvidia-cuda-12: "cuda12-insightface-development"
-- !!merge <<: *insightface_buffalo_s
-  name: "insightface-buffalo-s-development"
+  name: "insightface-development"
   capabilities:
     default: "cpu-insightface-development"
     nvidia: "cuda12-insightface-development"

gallery/index.yaml

@@ -3651,6 +3651,105 @@
     - filename: arcee-ai_AFM-4.5B-Q4_K_M.gguf
       sha256: f05516b323f581bebae1af2cbf900d83a2569b0a60c54366daf4a9c15ae30d4f
       uri: huggingface://bartowski/arcee-ai_AFM-4.5B-GGUF/arcee-ai_AFM-4.5B-Q4_K_M.gguf
+- &insightface_buffalo_l
+  name: "insightface-buffalo-l"
+  url: "github:mudler/LocalAI/gallery/virtual.yaml@master"
+  icon: https://avatars.githubusercontent.com/u/53104118?s=200&v=4
+  # The insightface library is MIT but the `buffalo_l` weights are
+  # released for NON-COMMERCIAL research use only.
+  license: "insightface-non-commercial"
+  description: |
+    Face recognition model using insightface's `buffalo_l` pack
+    (SCRFD-10GF detector + ResNet50 ArcFace 512-d embedder + genderage head).
+    Highest accuracy among the shipped options. Pre-baked inside the
+    `insightface` backend image (~326MB).
+
+    NON-COMMERCIAL RESEARCH USE ONLY — the model weights carry upstream's
+    research-only license. For commercial use install `insightface-opencv`
+    (Apache 2.0).
+  tags:
+    - face-recognition
+    - face-verification
+    - face-embedding
+    - research-only
+    - gpu
+    - cpu
+  urls:
+    - https://github.com/deepinsight/insightface
+  overrides:
+    backend: insightface
+    parameters:
+      model: insightface-buffalo-l
+    options:
+      - "engine:insightface"
+      - "model_pack:buffalo_l"
+    known_usecases:
+      - face_recognition
+      - detection
+      - embeddings
+- &insightface_opencv
+  name: "insightface-opencv"
+  url: "github:mudler/LocalAI/gallery/virtual.yaml@master"
+  license: apache-2.0
+  description: |
+    Face recognition model using OpenCV Zoo weights: YuNet detector +
+    SFace recognizer. APACHE 2.0 — safe for commercial use.
+    Lower accuracy than `buffalo_l` and no age/gender analysis
+    (SFace has no demographic head). Pre-baked inside the
+    `insightface` backend image (~40MB).
+  tags:
+    - face-recognition
+    - face-verification
+    - face-embedding
+    - commercial-ok
+    - gpu
+    - cpu
+  urls:
+    - https://github.com/opencv/opencv_zoo
+  overrides:
+    backend: insightface
+    parameters:
+      model: insightface-opencv
+    options:
+      - "engine:onnx_direct"
+      - "detector_onnx:models/opencv/yunet.onnx"
+      - "recognizer_onnx:models/opencv/sface.onnx"
+    known_usecases:
+      - face_recognition
+      - detection
+      - embeddings
+- &insightface_buffalo_s
+  name: "insightface-buffalo-s"
+  url: "github:mudler/LocalAI/gallery/virtual.yaml@master"
+  icon: https://avatars.githubusercontent.com/u/53104118?s=200&v=4
+  license: "insightface-non-commercial"
+  description: |
+    Smaller insightface pack for low-resource deployments
+    (SCRFD-500MF detector + MBF embedder + genderage head, ~159MB).
+    NOT pre-baked: weights are downloaded on first use into the
+    backend's working directory.
+
+    NON-COMMERCIAL RESEARCH USE ONLY.
+  tags:
+    - face-recognition
+    - face-verification
+    - face-embedding
+    - research-only
+    - edge
+    - cpu
+  urls:
+    - https://github.com/deepinsight/insightface
+  overrides:
+    backend: insightface
+    parameters:
+      model: insightface-buffalo-s
+    options:
+      - "engine:insightface"
+      - "model_pack:buffalo_s"
+    known_usecases:
+      - face_recognition
+      - detection
+      - embeddings
 - &rfdetr
   name: "rfdetr-base"
   url: "github:mudler/LocalAI/gallery/virtual.yaml@master"