CoolFace
Modelpublic

dronefreak/visdrone-yolov10n

sourceHugging Faceagpl-3.0updated 4m agoView on Hugging Face
6likes116downloads
Model Card

YOLOv10n Finetuned on VisDrone-DET

Fine-tuned YOLOv10n object detector on the VisDrone-DET benchmark dataset, trained and evaluated as part of DetectionBench -- a framework for reproducibly benchmarking modern object detectors with identical training recipes and evaluation metrics across multiple real-world datasets.

<!-- Demo banner: side-by-side video of this checkpoint's detections on two VisDrone-DET test clips. Media lives under assets/ in this repo. The <video> renders on the Hugging Face model page (absolute resolve/ URL); on GitHub the nested <img> poster is shown instead. --> <p align="center"><video controls autoplay loop muted playsinline width="900" poster="https://huggingface.co/dronefreak/visdrone-yolov10n/resolve/main/assets/demobannerposter.jpg" src="https://huggingface.co/dronefreak/visdrone-yolov10n/resolve/main/assets/demobanner.mp4"><img src="https://huggingface.co/dronefreak/visdrone-yolov10n/resolve/main/assets/demobanner_poster.jpg" alt="YOLOv10n detections on two VisDrone-DET test clips" width="900"></video></p>

<br>

<!-- ROW 1: Identity & Tech Stack --> <div style="display: flex; justify-content: center; align-items: center; gap: 8px; margin-bottom: 8px; flex-wrap: wrap;"> <img src="https://img.shields.io/badge/Task-ObjectDetection-blue?style=flat-square" alt="Task"> <img src="https://img.shields.io/badge/Framework-UltralyticsYOLO-0aa1a7?style=flat-square" alt="Framework"> <img src="https://img.shields.io/badge/Base_Model-YOLOv10n-purple?style=flat-square" alt="Base Model"> </div>

<!-- ROW 2: Performance Metrics --> <div style="display: flex; justify-content: center; align-items: center; gap: 8px; margin-bottom: 8px; flex-wrap: wrap;"> <img src="https://img.shields.io/badge/mAP@50-39.8%25-success?style=flat-square" alt="mAP@50"> <img src="https://img.shields.io/badge/mAP@50:95-23.08%25-orange?style=flat-square" alt="mAP@50:95"> <img src="https://img.shields.io/badge/Params-2.8M-lightgrey?style=flat-square" alt="Params"> </div>

<!-- ROW 3: Metadata --> <div style="display: flex; justify-content: center; align-items: center; gap: 8px; margin-bottom: 24px; flex-wrap: wrap;"> <img src="https://img.shields.io/badge/License-AGPL--3.0-lightgrey?style=flat-square" alt="License"> <a href="https://github.com/dronefreak/DetectionBench"><img src="https://img.shields.io/badge/Source-DetectionBench-black?style=flat-square" alt="Source"></a> </div>


Performance

MetricScore (%)
mAP@5039.8
mAP@50-9523.08
Precision51.22
Recall41.5
F1 Score45.85
Parameters2.8M
FLOPs8.7B (at 640 px)

Evaluation Protocol

Metrics reported in this model card are computed on the VisDrone-DET test split, using DetectionBench's standard evaluation pipeline (detectionbench-evaluate).


VisDrone-DET Model Zoo

Every model DetectionBench has trained and evaluated on VisDrone-DET so far, for full transparency -- see DetectionBench for the smaller, curated comparison set used on the project README.

ModelmAP@50mAP@50-95PrecisionRecall
YOLOv9s45.3826.9556.9546.19
YOLOv10s44.5126.2855.9745.61
YOLOv8s43.4725.7756.0944.51
YOLOv9t40.6723.7352.8441.78
YOLOv26n39.922.9551.1442.08
YOLOv10n39.823.0851.2241.5
YOLOv8n39.6923.0352.0241.36
YOLOv11n39.5223.051.4941.02
RF-DETR Nano37.9220.8869.0246.21

Earlier VisDrone-DET Results (Companion Codebase)

The rows below are earlier VisDrone2019-DET runs (test split) from a separate companion codebase (VisDrone-dataset-python-toolkit), not reproduced inside DetectionBench and kept here for context and history. Where a model also appears in the Model Zoo table above, that row is the current DetectionBench run and supersedes the one here -- for example the earlier YOLOv9t run used 640 px inputs and 300 epochs, while the current DetectionBench YOLO runs use 1280 px. The RF-DETR rows are earlier DetectionBench-trained runs at RF-DETR's default input sizes (384/512/576 px).

ModelmAP@50mAP@50-95PrecisionRecall
YOLOv9e40.0223.7354.7842.42
YOLOv11x38.4422.652.4141.43
YOLOv26x38.3322.4852.9141.06
YOLOv11l37.1421.8551.8740.33
YOLOv10x37.2421.8152.5939.84
YOLOv26l37.6521.7551.640.42
YOLOv9c37.2221.7351.9939.77
YOLOv8x36.8121.5251.9139.78
YOLOv26m36.6721.2251.0339.79
YOLOv10l35.9521.0952.1338.48
YOLOv11m36.3521.0250.2439.46
YOLOv9m36.1920.9551.0539.12
RF-DETR-Medium36.8220.1464.047.05
YOLOv8m34.3919.9548.1838.2
YOLOv9s33.5219.2646.1637.43
YOLOv11s32.318.4745.4935.31
YOLOv8s31.9518.2445.9935.49
YOLOv26s32.118.0645.7535.05
RF-DETR-Small33.2517.8862.6243.51
YOLOv9t29.0916.2242.5732.66
YOLOv8n28.1815.7740.8631.81
YOLOv11n27.5915.4639.5831.74
YOLOv10n27.6515.3241.0231.68
YOLOv26n26.7314.6438.631.14
RF-DETR-Nano25.1512.7758.9935.0
rtdetrl21.689.3435.7626.3

Source: https://huggingface.co/collections/dronefreak/visdrone-object-detection-model-zoo


Per-Class Performance

ClassmAP@50mAP@50-95
pedestrian38.8716.05
people23.118.4
bicycle17.777.56
car78.8850.88
van43.4929.69
truck46.830.01
tricycle25.4414.51
awning-tricycle23.3513.79
bus60.5943.13
motor39.7216.78
others0.00.0

Evaluation Visualizations

Precision-Recall Curve

[image]

F1 Curve

[image]

Confusion Matrix

[image]

Normalized Confusion Matrix

[image]


Dataset

This model was trained on VisDrone-DET. For the full dataset description, provenance, license, and citation, see the dataset card:

https://huggingface.co/datasets/Voxel51/VisDrone2019-DET

Classes

  • pedestrian
  • people
  • bicycle
  • car
  • van
  • truck
  • tricycle
  • awning-tricycle
  • bus
  • motor
  • others ---

Usage

Install Dependencies

bash
pip install ultralytics huggingface_hub

Load Model from Hugging Face

python
from huggingface_hub import hf_hub_download
from ultralytics import YOLO

weights = hf_hub_download(
    repo_id="dronefreak/visdrone-yolov10n",
    filename="best.pt"
)

model = YOLO(weights)

Run Inference

python
results = model.predict(
    source="image.jpg",
    conf=0.25
)

results[0].show()

Training Configuration

SettingValue
DatasetVisDrone-DET
FrameworkUltralytics YOLO
Training ToolkitDetectionBench
Epochs (configured max)100
Epochs (actually trained)100
Early Stopping Patience25
Batch Sizeauto (Ultralytics AutoBatch)
Image Size1280
OptimizerSGD
Initial Learning Rate0.01
Seed0

Repository Contents

text
best.pt
results.csv
args.yaml
BoxPR_curve.png
BoxF1_curve.png
BoxP_curve.png
BoxR_curve.png
confusion_matrix.png
confusion_matrix_normalized.png
val_batch0_pred.jpg
visdrone_yolov10n_showcase.jpg
assets/demo_banner.mp4
assets/demo_banner_poster.jpg
README.md

Related Resources


Training Framework

This model was trained using DetectionBench, an open-source framework for benchmarking object detectors across multiple real-world datasets with a common pipeline.

Features include:

  • A dataset-adapter registry for converting real-world datasets into a canonical format
  • Identical training/evaluation recipes across model families (Ultralytics YOLO/RT-DETR, RF-DETR)
  • Hardware profiling (latency, FPS, VRAM, parameters, FLOPs)
  • One-command reproducibility via versioned Hydra configs

If you find this model useful, please consider starring the repository.


Known Limitations

  • Severe class imbalance: car (42.21%) and pedestrian (23.12%) account for two-thirds of all annotated boxes in the training set, while awning-tricycle (0.95%) and tricycle (1.40%) are rare -- the others class has zero annotated instances in the training set entirely and is effectively unusable (always 0 AP).
  • Extreme small-object density: ~53 annotated boxes per image on average, with roughly 69% of boxes covering under 0.1% of the image area -- consistent with VisDrone's aerial small-object detection challenge (objects captured from significant altitude).
  • The original authors license VisDrone under CC BY-NC-SA 3.0 -- non-commercial research use only (see the dataset's homepage); this applies to any model trained on it, not only the raw images.
  • These RF-DETR checkpoints were trained/evaluated directly through DetectionBench. The YOLO/RT-DETR rows in the External VisDrone Model Zoo comparison below were trained via a separate companion codebase, not reproduced inside DetectionBench -- see that collection for their own training details and caveats. ---

Citation

If you use this model in your research, please consider citing:

  1. 1.The VisDrone-DET dataset (see below)
  2. 2.The original YOLOv10n architecture (see below)
  3. 3.The other model architectures shown in the Model Zoo/External Comparison tables above, if you reference their results
  4. 4.DetectionBench, the training/evaluation framework used to produce this checkpoint
@article{zhu2018vision,
  title={Vision meets drones: A challenge},
  author={Zhu, Pengfei and Wen, Longyin and Bian, Xiao and Ling, Haibin and Hu, Qinghua},
  journal={arXiv preprint arXiv:1804.07437},
  year={2018}
}
bibtex
@article{wang2024yolov10,
  title={YOLOv10: Real-Time End-to-End Object Detection},
  author={Wang, Ao and Chen, Hui and Liu, Lihao and Chen, Kai and Lin, Zijia and Han, Jungong and Ding, Guiguang},
  journal={arXiv preprint arXiv:2405.14458},
  year={2024}
}

Other architectures compared against on VisDrone-DET in this model card:

RF-DETR

bibtex
@inproceedings{robinson2026rfdetr,
  title     = {RF-DETR: Real-Time Detection Transformer},
  author    = {Robinson, Isaac and Robicheaux, Peter and Popov, Matvei and Ramanan, Deva and Peri, Neehar},
  booktitle = {International Conference on Learning Representations (ICLR)},
  year      = {2026},
  url       = {https://arxiv.org/abs/2511.09554}
}

@article{oquab2023dinov2,
  title={DINOv2: Learning Robust Visual Features without Supervision},
  author={Oquab, Maxime and Darcet, Timoth{\'e}e and Moutakanni, Theo and Vo, Huy and Szafraniec, Marc and Khalidov, Vasil and Fernandez, Pierre and Haziza, Daniel and Massa, Francisco and El-Nouby, Alaaeldin and others},
  journal={arXiv preprint arXiv:2304.07193},
  year={2023}
}

YOLOv11

bibtex
No official YOLO11 research paper has been published by Ultralytics; the most commonly cited independent architectural analysis is used instead:

@article{khanam2024yolov11,
  title={YOLOv11: An Overview of the Key Architectural Enhancements},
  author={Khanam, Rahima and Hussain, Muhammad},
  journal={arXiv preprint arXiv:2410.17725},
  year={2024}
}

YOLOv26

bibtex
@article{jocher2026yolo26,
  title={Ultralytics YOLO26: Unified Real-Time End-to-End Vision Models},
  author={Jocher, Glenn and Qiu, Jing and Liu, Mengyu and Lyu, Shuai and Akyon, Fatih Cagatay and Kalfaoglu, Muhammet Esat},
  journal={arXiv preprint arXiv:2606.03748},
  year={2026}
}

YOLOv8

bibtex
No official YOLOv8 research paper has been published by Ultralytics; this is their own recommended software citation instead:

@software{jocher2023yolov8,
  author = {Glenn Jocher and Ayush Chaurasia and Jing Qiu},
  title = {Ultralytics YOLOv8},
  version = {8.0.0},
  year = {2023},
  url = {https://github.com/ultralytics/ultralytics},
  license = {AGPL-3.0}
}

YOLOv9

bibtex
@article{wang2024yolov9,
  title={YOLOv9: Learning What You Want to Learn Using Programmable Gradient Information},
  author={Wang, Chien-Yao and Yeh, I-Hau and Liao, Hong-Yuan Mark},
  journal={arXiv preprint arXiv:2402.13616},
  year={2024}
}
bibtex
@software{Saksena_DetectionBench_2026,
  author = {Saksena, Saumya Kumaar},
  title = {DetectionBench: Reproducible Benchmarks for Modern Object Detectors on Real-World Datasets},
  url = {https://github.com/dronefreak/DetectionBench},
  year = {2026}
}