models.json schema v2: family_meta + per-entry requirements (min_ram_mb, fp16 excludes)

models.json

@@ -1,8 +1,18 @@
 {
-  "schema": 1,
+  "schema": 2,
   "repo": "tphakala/BirdNET-Geomodel",
   "family": "birdnet-geomodel",
   "updated": "2026-07-24",
+  "family_meta": {
+    "display_name": "BirdNET Geomodel v3.0",
+    "description": "Spatiotemporal species occurrence prediction for post-filtering acoustic detections. Predicts which species are likely at a given location and week of the year.",
+    "author": "Stefan Kahl, Cornell Lab of Ornithology",
+    "license": "CC-BY-SA-4.0",
+    "commercial_use": true,
+    "upstream_url": "https://github.com/birdnet-team/geomodel",
+    "species_count": 12012
+  },
+  "requirements_note": "requirements.min_ram_mb is a conservative, high-biased RAM floor: measured peak RSS + 15% where a benchmark exists, else a size-derived estimate biased high (a too-low floor risks OOM; a too-high floor only over-excludes on the smallest devices). Measured values will replace the estimates over time.",
   "naming": "legacy names, frozen; new files follow <family>-<upstream>[-<region>]-<variant>-b<build>.<ext>",
   "selection": {
     "x86-64/onnxruntime": "birdnet-geomodel-v3.0-fp32.onnx",
@@ -74,7 +84,13 @@
       "sha256": "2bc5a9b1e7c24115730015a97dbb688e9e8cd49c02c34a011439182c65ef0017",
       "size_bytes": 7483473,
       "superseded_by": null,
-      "notes": "upstream filename as published by the BirdNET team"
+      "notes": "upstream filename as published by the BirdNET team",
+      "requirements": {
+        "min_ram_mb": 200,
+        "excludes": [
+          "openvino-gpu-intel-gen12"
+        ]
+      }
     },
     {
       "path": "birdnet-geomodel-v3.0-fp32.onnx",
@@ -138,7 +154,10 @@
       "backend_support_verified": true,
       "sha256": "b151f680a47de5371f39b3df129aea5946ac6baa039582274f833b42eaf992ea",
       "size_bytes": 14700313,
-      "superseded_by": null
+      "superseded_by": null,
+      "requirements": {
+        "min_ram_mb": 200
+      }
     },
     {
       "path": "birdnet-geomodel-v3.0-fp16.onnx",
@@ -202,7 +221,13 @@
       "backend_support_verified": false,
       "sha256": "2bc5a9b1e7c24115730015a97dbb688e9e8cd49c02c34a011439182c65ef0017",
       "size_bytes": 7483473,
-      "superseded_by": null
+      "superseded_by": null,
+      "requirements": {
+        "min_ram_mb": 200,
+        "excludes": [
+          "openvino-gpu-intel-gen12"
+        ]
+      }
     }
   ]
-}
+}