# 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

```yaml
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.