train-eval
Use this sub-skill when a task asks how to train, evaluate, resume, benchmark, debug a config, or launch an AdelaiDet model family through the repository's Detectron2-style training workflow.
Use this route for
- Selecting a config family for FCOS, BlendMask, CondInst, BoxInst, SOLOv2, MEInst, FCPose, DenseCL, or non-text detection/segmentation tasks.
- Building safe AdelaiDet training/evaluation commands with config overrides.
- Running
--eval-only,--resume, distributed launch flags, or checkpoint-backed evaluation. - Understanding output directories, dataset names, solver/batch overrides, and
MODEL.WEIGHTSbehavior. - Diagnosing model registry/config errors after installation is already healthy.
Do not use this route for
- Install/build/import failures. Use
../setup-build/SKILL.mdfirst. - Text spotting lexicons/dictionaries/evaluation. Use
../text-spotting/SKILL.md. - Dataset conversion or semantic mask generation. Use
../data-prep/SKILL.md. - Demo visualization only. Use
../demo-visualize/SKILL.md. - Checkpoint key conversion or ONNX export. Use
../export-convert/SKILL.md.
Read first
references/config-selection.mdto choose a model/config family.references/train-eval-workflows.mdfor launch patterns, flags, and outputs.../../references/model-overview.mdfor package-wide model routing.../../references/api-reference.mdfor verified config and registry surfaces.
Skill-owned scripts
scripts/run_train_eval.py— validates common paths and builds/runs an AdelaiDet training or evaluation command. Use--dry-runbefore expensive jobs.
Typical workflow
-
Confirm setup:
bashpython ../../scripts/check_install.py --cuda-ops -
Choose the config family and config YAML.
-
Confirm datasets are registered and available; switch to
data-prepif not. -
Dry-run the launch:
bashpython scripts/run_train_eval.py --repo-root /path/to/AdelaiDet \ --config configs/FCOS-Detection/R_50_1x.yaml --num-gpus 1 --dry-run -
Add
--eval-only --model-weights /path/to/model.pthfor evaluation-only runs, or--resumefor continuation. -
Inspect
OUTPUT_DIR, logs, metrics, checkpoints, and evaluator output.
Decision points
- If the task names BAText/ABCNet or text recognition, load
text-spottingbefore finalizing training flags. - If the config references generated semantic masks, PIC/LVIS/COCO conversions, or MEInst components, load
data-prepbefore launch. - If checkpoint keys mismatch, switch to
export-convertfor conversion utilities. - If
No object named ... in registryappears, verify setup/import first, then check config family/key spelling.


