geointel/docs/MODEL_REGISTRY_SEED.md

Model Registry Seed

The application must ship with a deterministic demo model registry before real ML models are integrated.

Seed Models

demo-yolo-buildings-v1

• framework: demo
• task: object_detection
• classes: building
• purpose: deterministic demo detections for UI and QA/QC development
• production_ready: false

demo-seg-vegetation-v1

• framework: demo
• task: segmentation
• classes: vegetation, water, impervious_surface
• purpose: deterministic segmentation polygons for UI and metrics development
• production_ready: false

ultralytics-yolo-placeholder

• framework: ultralytics
• task: object_detection
• classes: configurable
• purpose: real YOLO integration slot
• production_ready: false until implemented and tested

sam-placeholder

• framework: segment-anything
• task: segmentation
• classes: prompt_based
• purpose: real SAM integration slot
• production_ready: false until implemented and tested

Registry Fields

{
  "id": "demo-yolo-buildings-v1",
  "name": "Demo YOLO Buildings",
  "version": "1.0.0",
  "framework": "demo",
  "task": "object_detection",
  "classes": ["building"],
  "artifact_path": null,
  "metadata": {
    "deterministic": true,
    "portfolio_demo": true
  }
}

Rules

• Demo models must be clearly labeled as non-production.
• Real model integration must not silently replace demo behavior.
• Model outputs must always include model id and version.