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.0b9

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.0b9
File Size Uploaded
litdet-0.1.0b9.tar.gz 58.6 kB Details

Built distribution (wheel)

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

Total release size: 131.5 kB

Release files / litdet-0.1.0b9.tar.gz

Download URL litdet-0.1.0b9.tar.gz
Size 58.6 kB
Tags Source
SHA-256 checksum
How to use checksums
346cacb6391dacb4ec14f20ae5b90fe164b138e8f56fd4cd39f6e313c511875d
BLAKE2b-256 checksum
How to use checksums
3f86338875c2fd382e83317f183bc2e32f1eb0b7fde98a7d1c1b08161fb111c7
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.0b9-py3-none-any.whl

Download URL litdet-0.1.0b9-py3-none-any.whl
Size 72.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
23126a8250fa2965c85ff27d7153415f3c03783b5b6e5c0e1d1db633f46ce53c
BLAKE2b-256 checksum
How to use checksums
10675514ff89b83ec705a9301aac98480450e9936c142bbebe8f9ad329ecdaf3
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