Metadata-Version: 2.1
Name: project-lighter
Version: 0.0.2a10
Summary: YAML-based automated rapid prototyping framework for deep learning experiments
Home-page: https://github.com/lighter/lighter
License: MIT
Author: Ibrahim Hadzic
Author-email: ibrahimhadzic45@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: fire (>=0.5.0,<0.6.0)
Requires-Dist: lightly (>=1.2.43,<2.0.0)
Requires-Dist: loguru (>=0.6.0,<0.7.0)
Requires-Dist: monai-weekly (>=1.2.dev2305,<2.0)
Requires-Dist: pandas (>=1.5.3,<2.0.0)
Requires-Dist: pytorch-lightning (>=2.0.0,<3.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Requires-Dist: tensorboard (>=2.11.2,<3.0.0)
Requires-Dist: torch (==2.0)
Requires-Dist: torchmetrics (>=0.11.0,<0.12.0)
Requires-Dist: torchvision (>=0.15,<0.16)
Project-URL: Repository, https://github.com/lighter/lighter
Description-Content-Type: text/markdown

<div align="center">
<picture>
  <source media="(prefers-color-scheme: dark)" srcset="./assets/images/lighter_dark.png">
  <source media="(prefers-color-scheme: light)" srcset="./assets/images/lighter_light.png">
  <img align="center" alt="Lighter logo" src="h/assets/images/lighter_dark.png">
</picture>
</div>
<br/>
<div align="center">

 [![build](https://github.com/project-lighter/lighter/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/project-lighter/lighter/actions/workflows/build.yml) ![Coverage](./assets/images/coverage.svg) [![GitHub license](https://img.shields.io/github/license/project-lighter/lighter)](https://github.com/project-lighter/lighter/blob/main/LICENSE)
</div>


Welcome to `lighter`, an elegant and powerful wrapper for [PyTorch Lightning](https://github.com/Lightning-AI/lightning) that simplifies the way you build and manage your deep learning experiments. Unleash your model's potential through a unified, **configuration-based** approach that streamlines the experimentation process, empowering both beginners and experts in the field.


## 🚀 Install

Current release:
````
pip install project-lighter
````

Pre-release (up-to-date with the main branch):
````
pip install project-lighter --pre
````

For development:
````
make setup
make install             # Install lighter via Poetry
make pre-commit-install  # Set up the pre-commit hook for code formatting
poetry shell             # Once installed, activate the poetry shell
````

## 📖 Usage

- [Documentation]()
- [Video Tutorials]()

## 💡 Projects
List of projects that use `lighter`:

| Project | Description |
| --- | --- |
| [Foundation Models for Quantitative Imaging Biomarker Discovery in Cancer Imaging](https://aim.hms.harvard.edu/foundation-cancer-image-biomarker) | A foundation model for lesions on CT scans that can be applied to down-stream tasks related to tumor radiomics, nodule classification, etc. |


## 📄 Cite:

If you find `lighter` useful in your research or project, please consider citing it. Here's an example BibTeX citation entry:

```bibtex
@software{lighter,
  author       = {Ibrahim Hadzic and
                  Suraj Pai and
                  Keno Bressem and
                  Hugo Aerts},
  title        = {Lighter},
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.8007711},
  url          = {https://doi.org/10.5281/zenodo.8007711}
}
```

We appreciate your support!

