geointel/docs/MODEL_REGISTRY_SPEC.md

Model Registry Specification

Purpose

The model registry tracks which AI models are available, what they can detect or segment, and how outputs should be interpreted.

V1 model record

id: yolov8n-building-demo
name: YOLO Building Demo
framework: ultralytics
runtime: pytorch
task: object_detection
version: 0.1.0
classes:
  - building
input:
  tile_size: 640
  channels: 3
outputs:
  type: bounding_boxes
metrics:
  mAP50: null
  precision: null
  recall: null
status: experimental

Required metadata

• id
• name
• framework
• task
• version
• classes
• artifact_path or provider
• input constraints
• output schema
• status

Status values

• experimental
• validated
• deprecated
• disabled

Rule

Detection and segmentation services must request model info through the registry. They must not hardcode model paths in API routes.