Validation & acceptance testing - Bioptimus Documentation

Use these checks after deploying (on-premise or SageMaker) to confirm the service is healthy and producing expected results.

1. Service health

curl -s http://localhost:8080/ping | python3 -m json.tool
# {"status": "ok", "models": ["h1", "tissue-seg"]}

curl -s http://localhost:8080/ping | python3 -m json.tool
# {"status": "ok", "models": ["m-optimus", "tissue-seg"]}

2. Model availability (SDK)

available_backbones() lists the models the Bioptimus SDK can construct (read from its bundled configs) — it does not query the server. The /ping response in step 1 is the source of truth for what the deployed endpoint actually serves.

from bioptimus.models.backbones import Backbone
print(Backbone.available_backbones())
# ['h1', 'm-optimus', 'tissue-seg']

3. Output shape checks

Model	Expected output length
H-Optimus (`/api/embed/h1`)	1536
M-Optimus embedding	1536
M-Optimus prediction	number of output genes (see `/api/metadata/m-optimus`)
Tissue segmentation	H×W (262,144 for a 512×512 tile)