# lightning-utilities

> Lightning toolbox for across the our ecosystem.

- **URL**: https://www.freshcrate.ai/projects/lightning-utilities
- **Author**: Lightning AI et al.
- **Category**: Developer Tools
- **Latest version**: `0.15.3` (2026-04-21)
- **License**: Apache-2.0
- **Source**: https://github.com/Lightning-AI/utilities/issues
- **Homepage**: https://github.com/Lightning-AI/utilities
- **Language**: Python
- **GitHub**: 62 stars, 24 forks
- **Registry**: pypi (`lightning-utilities`)
- **Tags**: `ci/cd`, `devops`, `pypi`, `utilities`

## Description

# Lightning Utilities

[![PyPI Status](https://badge.fury.io/py/lightning-utilities.svg)](https://badge.fury.io/py/lightning-utilities)
[![license](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/Lightning-AI/utilities/blob/main/LICENSE)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/lightning-utilities)](https://pepy.tech/project/lightning-utilities)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/lightning-utilities)](https://pypi.org/project/lightning-utilities/)

[![UnitTests](https://github.com/Lightning-AI/utilities/actions/workflows/ci-testing.yml/badge.svg?event=push)](https://github.com/Lightning-AI/utilities/actions/workflows/ci-testing.yml)
[![Apply checks](https://github.com/Lightning-AI/utilities/actions/workflows/ci-use-checks.yaml/badge.svg?event=push)](https://github.com/Lightning-AI/utilities/actions/workflows/ci-use-checks.yaml)
[![Docs Status](https://readthedocs.org/projects/lit-utilities/badge/?version=latest)](https://lit-utilities.readthedocs.io/en/latest/?badge=latest)
[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/Lightning-AI/utilities/main.svg)](https://results.pre-commit.ci/latest/github/Lightning-AI/utilities/main)

__This repository covers the following use-cases:__

1. _Reusable GitHub workflows_
2. _Shared GitHub actions_
3. _General Python utilities in `lightning_utilities.core`_
4. _CLI `python -m lightning_utilities.cli --help`_

## 1. Reusable workflows

__Usage:__

```yaml
name: Check schema

on: [push]

jobs:

  check-schema:
    uses: Lightning-AI/utilities/.github/workflows/check-schema.yml@v0.5.0
    with:
      azure-dir: ""  # skip Azure check

  check-code:
    uses: Lightning-AI/utilities/.github/workflows/check-code.yml@main
    with:
      actions-ref: main  # normally you shall use the same version as the workflow
```

See usage of other workflows in [.github/workflows/ci-use-checks.yaml](https://github.com/Lightning-AI/utilities/tree/main/.github/workflows/ci-use-checks.yaml).

## 2. Reusable composite actions

See available composite actions [.github/actions/](https://github.com/Lightning-AI/utilities/tree/main/.github/actions).

__Usage:__

```yaml
name: Do something with cache

on: [push]

jobs:
  pytest:
    runs-on: ubuntu-24.04
    steps:
    - uses: actions/checkout@v3
    - uses: actions/setup-python@v4
      with:
        python-version: 3.10
    - uses: Lightning-AI/utilities/.github/actions/cache
      with:
        python-version: 3.10
        requires: oldest # or latest
```

## 3. General Python utilities `lightning_utilities.core`

<details>
  <summary>Installation</summary>
From source:

```bash
pip install https://github.com/Lightning-AI/utilities/archive/refs/heads/main.zip
```

From pypi:

```bash
pip install lightning_utilities
```

</details>

__Usage:__

Example for optional imports:

```python
from lightning_utilities.core.imports import module_available

if module_available("some_package.something"):
    from some_package import something
```

## 4. CLI `lightning_utilities.cli`

The package provides common CLI commands.

<details>
  <summary>Installation</summary>

From pypi:

```bash
pip install lightning_utilities[cli]
```

</details>

__Usage:__

```bash
python -m lightning_utilities.cli [group] [command]
```

<details>
  <summary>Example for setting min versions</summary>

```console
$ cat requirements/test.txt
coverage>=5.0
codecov>=2.1
pytest>=6.0
pytest-cov
pytest-timeout
$ python -m lightning_utilities.cli requirements set-oldest
$ cat requirements/test.txt
coverage==5.0
codecov==2.1
pytest==6.0
pytest-cov
pytest-timeout
```

</details>

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `0.15.3` | 2026-04-21 | Low | Imported from PyPI (0.15.3) |
| `v0.15.3` | 2026-02-11 | Low | ## What's Changed  ### Added  - Added support for Python 3.14 ([#464](https://github.com/Lightning-AI/utilities/pull/464)) - Added AGENTS.md ([#428](https://github.com/Lightning-AI/utilities/pull/428)) - feat: specify standalone port ([#447](https://github.com/Lightning-AI/utilities/pull/447)) - chore(ci): add python version to build matrix ([#465](https://github.com/Lightning-AI/utilities/pull/465))  ### Changed  - Dropped support for Python 3.9, now requires Python >=3.10 ([#463](ht |
| `v0.15.3` | 2026-02-11 | Low | ## What's Changed  ### Added  - Added support for Python 3.14 ([#464](https://github.com/Lightning-AI/utilities/pull/464)) - Added AGENTS.md ([#428](https://github.com/Lightning-AI/utilities/pull/428)) - feat: specify standalone port ([#447](https://github.com/Lightning-AI/utilities/pull/447)) - chore(ci): add python version to build matrix ([#465](https://github.com/Lightning-AI/utilities/pull/465))  ### Changed  - Dropped support for Python 3.9, now requires Python >=3.10 ([#463](ht |
| `v0.15.3` | 2026-02-11 | Low | ## What's Changed  ### Added  - Added support for Python 3.14 ([#464](https://github.com/Lightning-AI/utilities/pull/464)) - Added AGENTS.md ([#428](https://github.com/Lightning-AI/utilities/pull/428)) - feat: specify standalone port ([#447](https://github.com/Lightning-AI/utilities/pull/447)) - chore(ci): add python version to build matrix ([#465](https://github.com/Lightning-AI/utilities/pull/465))  ### Changed  - Dropped support for Python 3.9, now requires Python >=3.10 ([#463](ht |
| `v0.15.3` | 2026-02-11 | Low | ## What's Changed  ### Added  - Added support for Python 3.14 ([#464](https://github.com/Lightning-AI/utilities/pull/464)) - Added AGENTS.md ([#428](https://github.com/Lightning-AI/utilities/pull/428)) - feat: specify standalone port ([#447](https://github.com/Lightning-AI/utilities/pull/447)) - chore(ci): add python version to build matrix ([#465](https://github.com/Lightning-AI/utilities/pull/465))  ### Changed  - Dropped support for Python 3.9, now requires Python >=3.10 ([#463](ht |
| `v0.15.3` | 2026-02-11 | Low | ## What's Changed  ### Added  - Added support for Python 3.14 ([#464](https://github.com/Lightning-AI/utilities/pull/464)) - Added AGENTS.md ([#428](https://github.com/Lightning-AI/utilities/pull/428)) - feat: specify standalone port ([#447](https://github.com/Lightning-AI/utilities/pull/447)) - chore(ci): add python version to build matrix ([#465](https://github.com/Lightning-AI/utilities/pull/465))  ### Changed  - Dropped support for Python 3.9, now requires Python >=3.10 ([#463](ht |
| `v0.15.3` | 2026-02-11 | Low | ## What's Changed  ### Added  - Added support for Python 3.14 ([#464](https://github.com/Lightning-AI/utilities/pull/464)) - Added AGENTS.md ([#428](https://github.com/Lightning-AI/utilities/pull/428)) - feat: specify standalone port ([#447](https://github.com/Lightning-AI/utilities/pull/447)) - chore(ci): add python version to build matrix ([#465](https://github.com/Lightning-AI/utilities/pull/465))  ### Changed  - Dropped support for Python 3.9, now requires Python >=3.10 ([#463](ht |
| `v0.15.3` | 2026-02-11 | Low | ## What's Changed  ### Added  - Added support for Python 3.14 ([#464](https://github.com/Lightning-AI/utilities/pull/464)) - Added AGENTS.md ([#428](https://github.com/Lightning-AI/utilities/pull/428)) - feat: specify standalone port ([#447](https://github.com/Lightning-AI/utilities/pull/447)) - chore(ci): add python version to build matrix ([#465](https://github.com/Lightning-AI/utilities/pull/465))  ### Changed  - Dropped support for Python 3.9, now requires Python >=3.10 ([#463](ht |
| `v0.15.3` | 2026-02-11 | Low | ## What's Changed  ### Added  - Added support for Python 3.14 ([#464](https://github.com/Lightning-AI/utilities/pull/464)) - Added AGENTS.md ([#428](https://github.com/Lightning-AI/utilities/pull/428)) - feat: specify standalone port ([#447](https://github.com/Lightning-AI/utilities/pull/447)) - chore(ci): add python version to build matrix ([#465](https://github.com/Lightning-AI/utilities/pull/465))  ### Changed  - Dropped support for Python 3.9, now requires Python >=3.10 ([#463](ht |
| `v0.15.3` | 2026-02-11 | Low | ## What's Changed  ### Added  - Added support for Python 3.14 ([#464](https://github.com/Lightning-AI/utilities/pull/464)) - Added AGENTS.md ([#428](https://github.com/Lightning-AI/utilities/pull/428)) - feat: specify standalone port ([#447](https://github.com/Lightning-AI/utilities/pull/447)) - chore(ci): add python version to build matrix ([#465](https://github.com/Lightning-AI/utilities/pull/465))  ### Changed  - Dropped support for Python 3.9, now requires Python >=3.10 ([#463](ht |

## Citation

- HTML: https://www.freshcrate.ai/projects/lightning-utilities
- Markdown: https://www.freshcrate.ai/projects/lightning-utilities.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/lightning-utilities/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._