Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

LitDet

Version PyPI Documentation Status License

Python pytorch lightning hydra

Platform CUDA

MRs

LitDet is a domain-agnostic AutoML framework to accelerate the development of 2D object detection models 🚀⚡🔥.

  • ML Workflows: Handles model pre-training, fine-tuning or re-training at scale.
  • Key Features: Provides a high-level CLI and python API for seamless hardware support (CPU/GPU), COCO-formatted dataset integration, and built-in experiment tracking.
  • Tech Stack: Built on the Lightning framework, it leverages PyTorch and Hydra for flexible, configuration-driven deep learning workflows.
LitDet overview

Quickstart

You will need at least python 3.10 installed on your machine. For efficient training, it is recommended to have a recent GPU driver (e.g. NVIDIA 525.147.05). It also works on Mac with MPS support.

  1. First install the package (best in a python venv).

    python -m pip install "litdet[extras]"
    
  2. Train a Faster-RCNN on your dataset annotated in COCO format at /path/to/your/dir/coco_dataset_name:

    light-train task/model=faster_rcnn paths.data_dir=/path/to/your/dir data.data_name=coco_dataset_name task.model.num_classes=10 trainer.max_epochs=100
    

Replace the 10 by the number of classes your model should predict.

You can find configuration examples in the /examples directory.

To build your own configuration file instead, use our cookiecutter:

cookiecutter https://gitlab.kitware.com/litdet/litdet.git --directory "cookiecutter-litdet"

For more information on the usage, configuration, API documentation, and getting started guides, refer to our online documentation.

Developers

See CONTRIBUTING for developers instructions such as code practices, or the review process. Check also our advanced usage guide, and debugging process.

Citation

You can cite LitDet with the following:

@article{litdet2026tetrel,
  title={LitDet: An AutoML Tool for Accelerating 2D Object Detection Experiments},
  author={Tetrel, Loic and Checchin, Thomas and Pagnier, Louis},
  journal={Journal of Open Source Software},
  year={2026}
}

Model Zoo

The LitDet model zoo serves as a centralized hub for users and developers to discover models.

You can explore the complete list of available pre-trained models directly in our GitLab repository.

Acknowledgements

Metadata

Release files for litdet 0.1.0b8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for litdet 0.1.0b8
File Size Uploaded
litdet-0.1.0b8.tar.gz 58.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for litdet 0.1.0b8
File Interpreter ABI Platform
litdet-0.1.0b8-py3-none-any.whl Python 3 none any Details

Total release size: 131.5 kB

Release files / litdet-0.1.0b8.tar.gz

Download URL litdet-0.1.0b8.tar.gz
Size 58.6 kB
Tags Source
SHA-256 checksum
How to use checksums
0e05522ee74af9711c61dbf7b1cc0d561b4945a2c3bb8c10cd06fcba99065c43
BLAKE2b-256 checksum
How to use checksums
a3532b9ca3f2fbe0badd0c7b12b821c3023482b5a59a0809c4d96ae131ca34a5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.21

Release files / litdet-0.1.0b8-py3-none-any.whl

Download URL litdet-0.1.0b8-py3-none-any.whl
Size 72.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
28db9dc5e097a39fd0d51ce7672a941818c2d1abc3bfa8701b62d64e09603ec9
BLAKE2b-256 checksum
How to use checksums
10935e7eb45bf24ba0cb3a0f302097b2ae8844fcfd6be351fa53659c3a54f275
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.21
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page