GeoIntel release gates / Compile, test, contracts and builds (push) Successful in 1m49s
GeoIntel release gates / Python and npm vulnerability policy (push) Successful in 21s
GeoIntel release gates / Production AI image, SBOM and container scan (push) Successful in 5m39s
GeoIntel release gates / Deploy exact gated revision to Unraid (push) Failing after 58m43s
35 lines
948 B
Markdown
35 lines
948 B
Markdown
# Model Adapter Guide
|
|
|
|
## Purpose
|
|
Detection and segmentation must be implemented behind stable adapters so V1 can support demo/local model flows while remaining ready for YOLO/SAM integration.
|
|
|
|
## Detection Adapter Interface
|
|
```python
|
|
class DetectionAdapter:
|
|
name: str
|
|
supported_classes: list[str]
|
|
def is_available(self) -> bool: ...
|
|
def predict(self, image_tile, parameters) -> list[DetectionResult]: ...
|
|
```
|
|
|
|
## Detection Result
|
|
Fields:
|
|
- class_name
|
|
- confidence
|
|
- bbox_pixel
|
|
- bbox_geo optional after georeferencing
|
|
- source_tile
|
|
- metadata
|
|
|
|
## Segmentation Adapter Interface
|
|
```python
|
|
class SegmentationAdapter:
|
|
name: str
|
|
supported_classes: list[str]
|
|
def is_available(self) -> bool: ...
|
|
def segment(self, image_tile, parameters) -> list[SegmentationResult]: ...
|
|
```
|
|
|
|
## V1 Rule
|
|
If real YOLO weights are not configured, use a demo adapter only when clearly labelled as demo and never present it as production AI.
|