---
title: README
emoji: ⚡
colorFrom: yellow
colorTo: green
sdk: static
pinned: false
---

# Detection datasets

*Easily load and transform datasets for object detection.*

---

**Documentation**: https://blinjrm.github.io/detection-datasets/  

**Source Code**: https://github.com/blinjrm/detection-datasets  

**Datasets on Hugging Face Hub**: https://huggingface.co/detection-datasets  

---

`detection_datasets` aims to make it easier to work with detection datasets.  

It is both an organisation sharing detection datasets on the 🤗 Hub, and a Python library to load, transform and export detection datasets to multiple formats corresponding to object detection frameworks / models. 

The main features are:
* **Read** the dataset :
    * From disk if it has already been downloaded.
    * Directly from the Hugging Face Hub if it [already exist](https://huggingface.co/detection-datasets).
* **Transform** the dataset:
    * Select a subset of data.
    * Remap categories.
    * Create new train-val-test splits.
* **Visualize** the annotations and images.
* **Write** the dataset:
    * To disk, selecting the target detection format: `COCO`, `YOLO` and more to come.
    * To the Hugging Face Hub for easy reuse in a different environment and share with the community.

**More datasets to come! 🔥**