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

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

Built distribution (wheel)

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

Total release size: 131.5 kB

Release files / litdet-0.1.0b7.tar.gz

Download URL litdet-0.1.0b7.tar.gz
Size 58.6 kB
Tags Source
SHA-256 checksum
How to use checksums
b4e61df24cb72b751edadd28d73ccc7e96ae33ae0e6ac3c71f0c3d686aaa7471
BLAKE2b-256 checksum
How to use checksums
70d71226f1c4449290ba7166ea9f57b2a89e65c6d5d7604d2c373815d322dc81
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.0b7-py3-none-any.whl

Download URL litdet-0.1.0b7-py3-none-any.whl
Size 72.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fd59f62ac2472ae9fabc18b7cf832c28217994760a4a747a34aa39db188d860d
BLAKE2b-256 checksum
How to use checksums
34d5c3f2c9046f25e8671a8df210fcae3ab7b33bdb755390cec851c6fbe5797a
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