libreyolo detany3d

Run detany3d 3D detection from the command line.

Synopsis

bash
libreyolo detany3d source=IMAGE [OPTIONS]

Arguments

ArgumentDefaultMeaning
sourcerequiredImage path or directory
modelupstream default checkpointLocal checkpoint or the mirrored default filename
runtime-pathNoneDetAny3D checkout; defaults to DETANY3D_PATH
runtime-pythonNoneInterpreter for the separate runtime environment
textNoneJSON category list or a text caption
bboxesNoneJSON original-pixel xyxy box list
pointsNoneJSON positive points, optionally grouped by object
confNoneText detector box-confidence threshold
text-thresholdNoneText token-confidence threshold
grounding-checkpointNoneOptional GroundingDINO Swin-B checkpoint path
grounding-configNoneOptional GroundingDINO Swin-B config path
deviceautoauto, cpu, or CUDA device
saveFalseSave projected cuboids
output-pathNoneSingle-image output filename
jsonfalseJSON output to stdout
quietFalseSuppress stderr
help-jsonfalseFlag: dump the command schema as JSON and exit

Examples

Inspect the installed command schema:

bash
libreyolo detany3d --help-json

Predict on the shipped sample image. DetAny3D estimates the camera intrinsics itself, so no calibration file is needed. Install the model's runtime before prediction.

bash
libreyolo detany3d source=https://raw.githubusercontent.com/LibreYOLO/libreyolo/release/libreyolo/assets/parkour.jpg text='["person"]'

Request machine-readable results:

bash
libreyolo detany3d source=https://raw.githubusercontent.com/LibreYOLO/libreyolo/release/libreyolo/assets/parkour.jpg text='["person"]' --json --quiet

Notes

Configuration, runtime-loading and I/O errors exit through the shared CLI error handler. --json writes structured results to stdout; diagnostics use stderr. --quiet suppresses stderr. See detany3d for installation, calibration and model constraints.

Verified against LibreYOLO v1.6.0.