yolox / README.md
Lekim89's picture
Upload README.md with huggingface_hub
bd3b337 verified
metadata
license: apache-2.0
tags:
  - object-detection
  - multi-object-tracking
  - yolox
  - sports-tracking
  - pedestrian-tracking
datasets:
  - MOT17
  - SportsMOT
  - DanceTrack
  - VisDrone
pipeline_tag: object-detection

YOLOX Detection Models for Multi-Object Tracking

A collection of fine-tuned YOLOX detector weights used as the detection backbone in BoxMOT tracking pipelines.

Available Models

File Fine-tuned On Evaluated On MOTA IDF1 HOTA IDs FPS Experiment
yolox_x_MOT17_ablation.pt CrowdHuman + MOT17 train first half MOT17 half val 76.6 79.3 β€” 159 29.6 yolox_x_ablation.py
yolox_x_MOT17_test.pt CrowdHuman + MOT17 full train + Cityperson + ETHZ MOT17 train 90.0 83.3 β€” 422 29.6 yolox_x_mix_det.py
yolox_x_MOT20_ablation.pt CrowdHuman + MOT20 train first half + Widerperson β€” β€” β€” β€” β€” β€” yolox_x_dance_val.py
yolox_x_MOT20_test.pt CrowdHuman + MOT20 full train MOT20 train 93.4 89.3 β€” 1057 17.5 yolox_x_mix_det.py
yolox_x_sportsmot.pt SportsMOT train + val SportsMOT test 96.3 79.8 77.2 β€” β€” yolox_x_ch_sportsmot.py
yolox_x_dancetrack.pt DanceTrack full train + CrowdHuman + Widerperson DanceTrack test 93.6 67.8 66.5 β€” β€” yolox_x_dance_test.py
yolox_x_visdrone.pt VisDrone-MOT trainval VisDrone-MOT test-dev 52.3 69.0 β€” 1052 19.4 yolox_x_u2mot_visdrone.py

All models are YOLOX-X (depth=1.33, width=1.25), input size 800Γ—1440 (except VisDrone: 896Γ—1600), single pedestrian class (except VisDrone: 10 classes). Size ~756 MB (VisDrone: 806 MB).

Origin & Citation

The DanceTrack and MOT20 YOLOX-X weights were trained following the procedure described in:

Focusing on Tracks for Online Multi-Object Tracking Kyujin Shim, Kangwook Ko, Yujin Yang, Changick Kim Korea Advanced Institute of Science and Technology (KAIST) CVPR 2025

The SportsMOT YOLOX-X weights were trained following the procedure described in:

Iterative Scale-Up ExpansionIoU and Deep Features Association for Multi-Object Tracking in Sports Hsiang-Wei Huang, Cheng-Yen Yang, Jiacheng Sun, Pyong-Kun Kim, Kwang-Ju Kim, Kyoungoh Lee, Chung-I Huang, Jenq-Neng Hwang Information Processing Lab, University of Washington; ETRI; National Center for High-Performance Computing arXiv:2306.13074 (2023)

The VisDrone YOLOX-X weights were trained following the procedure described in:

Uncertainty-aware Unsupervised Multi-Object Tracking Kai Liu, Sheng Jin, Zhihang Fu, Ze Chen, Rongxin Jiang, Jieping Ye Zhejiang University; Alibaba DAMO Academy arXiv:2307.15409 (2023)

The MOT17 YOLOX-X weights follow the ByteTrack-style training recipe originally proposed in:

ByteTrack: Multi-Object Tracking by Associating Every Detection Box Yifu Zhang, Peize Sun, Yi Jiang, Dongdong Yu, Zehuan Yuan, Ping Luo, Wenyu Liu, Xinggang Wang arXiv:2110.06864 (2021)

Usage with BoxMOT

These models are automatically downloaded when running BoxMOT benchmarks:

# MOT17 evaluation (auto-downloads yolox_x_MOT17_ablation.pt)
boxmot eval --benchmark mot17 --split ablation --tracker boosttrack

# SportsMOT evaluation (auto-downloads yolox_x_sportsmot.pt)
boxmot eval --benchmark sportsmot --split ablation --tracker boosttrack

Or use directly in Python:

from boxmot import Boxmot

# SportsMOT with YOLOX-X detector
tracker = Boxmot(detector="yolox_x_sportsmot", tracker="boosttrack")
results = tracker.track(source="path/to/video.mp4")

License

The YOLOX architecture is released under the Apache 2.0 License. Weights are provided for research purposes. Please cite the original papers when using these models.

@inproceedings{shim2025tracktrack,
  title={Focusing on Tracks for Online Multi-Object Tracking},
  author={Shim, Kyujin and Ko, Kangwook and Yang, Yujin and Kim, Changick},
  booktitle={CVPR},
  year={2025}
}

@article{huang2023deep,
  title={Iterative Scale-Up ExpansionIoU and Deep Features Association for Multi-Object Tracking in Sports},
  author={Huang, Hsiang-Wei and Yang, Cheng-Yen and Sun, Jiacheng and Kim, Pyong-Kun and Kim, Kwang-Ju and Lee, Kyoungoh and Huang, Chung-I and Hwang, Jenq-Neng},
  journal={arXiv preprint arXiv:2306.13074},
  year={2023}
}

@article{liu2023u2mot,
  title={Uncertainty-aware Unsupervised Multi-Object Tracking},
  author={Liu, Kai and Jin, Sheng and Fu, Zhihang and Chen, Ze and Jiang, Rongxin and Ye, Jieping},
  journal={arXiv preprint arXiv:2307.15409},
  year={2023}
}

@article{zhang2021bytetrack,
  title={ByteTrack: Multi-Object Tracking by Associating Every Detection Box},
  author={Zhang, Yifu and Sun, Peize and Jiang, Yi and Yu, Dongdong and Yuan, Zehuan and Luo, Ping and Liu, Wenyu and Wang, Xinggang},
  journal={arXiv preprint arXiv:2110.06864},
  year={2021}
}

@article{ge2021yolox,
  title={YOLOX: Exceeding YOLO Series in 2021},
  author={Ge, Zheng and Liu, Songtao and Wang, Feng and Li, Zeming and Sun, Jian},
  journal={arXiv preprint arXiv:2107.08430},
  year={2021}
}