yolo-tuning
Installation
SKILL.md
Improving models & hyperparameter tuning
The improvement playbook (follow in order — tuning is the LAST step)
Hyperparameter tuning is expensive and usually not the bottleneck. Escalate in this order, re-validating after each step:
- Fix the data — check
confusion_matrix.pngandtrain_batch*.jpgfor label noise; review the top false-negative/false-positive val images; add examples of failing classes and true-background images. Data quality beats every other lever. - Train longer — if val mAP was still rising at the end: more
epochs, higherpatience. - Bigger input — small objects or mAP50 ≫ mAP50-95: raise
imgsz(640 → 960/1280). - Bigger model — underfitting (train and val both mediocre): n → s → m → l.
- Domain-matched augmentation — aerial
degrees=180 flipud=0.5, crowded scenesmixup=0.1(pluscopy_paste=0.3for segment/OBB), color-critical classes lowerhsv_h(see yolo-training'straining-args.md). - Only now: hyperparameter tuning — worth ~0.5–2 mAP when everything above is exhausted.
Decision signals: overfitting (val drops while train improves) → more data/aug or smaller model, NOT tuning. Underfitting → bigger model/longer, NOT tuning. Label noise in the confusion matrix → nothing else matters until fixed.
Compare experiments in Platform
Keep candidates in one Platform project. Train from the New Model dialog, ask Ask AI to run and compare experiments (AutoTrain), or stream authenticated local runs by setting project=username/project-slug and a unique name. Select models together in the project charts, or use Table > Diff to compare training arguments and final metrics.