demo-visualize
Use this sub-skill when a task asks to run AdelaiDet inference on images, videos, webcam streams, visualize predictions, adjust confidence thresholds, or inspect dataset annotations visually.
Use this route for
- Building AdelaiDet demo commands for image, video, or webcam inference.
- Understanding
VisualizationDemo, Detectron2 predictors, and output behavior. - Running dataset visualization before training.
- Debugging missing
MODEL.WEIGHTS, input/output path, OpenCV, or headless-display issues. - Visualizing text/non-text predictions after setup succeeds.
Do not use this route for
- Environment/build failures. Use
../setup-build/SKILL.md. - Training/evaluation launches. Use
../train-eval/SKILL.md. - Text lexicons/dictionaries or text evaluator behavior. Use
../text-spotting/SKILL.md. - Dataset conversion/preparation. Use
../data-prep/SKILL.md. - ONNX export. Use
../export-convert/SKILL.md.
Read first
references/demo-workflows.mdfor image/video/webcam launch patterns.references/visualization.mdfor dataset visualization and output interpretation.../../references/troubleshooting.mdfor OpenCV/headless and checkpoint issues.
Skill-owned scripts
scripts/run_demo.py— validates repo root, config, weights, input/output mode, then builds/runs the demo command.scripts/visualize_dataset.py— validates and launches the dataset visualization workflow.
Typical workflow
-
Confirm setup with
../../scripts/check_install.py --cuda-ops. -
Choose a config and weights. Use
train-evalif you are not sure which config family fits. -
Dry-run the demo:
bashpython scripts/run_demo.py --repo-root /path/to/AdelaiDet \ --config configs/FCOS-Detection/R_50_1x.yaml \ --weights /path/to/model.pth --input image.jpg --output outputs/ --dry-run -
Remove
--dry-runto execute. -
For dataset visual inspection, use
scripts/visualize_dataset.py --dry-runfirst.
Decision points
- Headless server with no display: use image/video input and
--output; avoid webcam or GUI window modes. - Text model predictions: use this route for drawing outputs, but switch to
text-spottingfor lexicon/evaluation semantics. - Missing/incorrect boxes or masks with a custom dataset: switch to
data-prepto inspect annotations and dataset mappers.


