Skip to main content

Discord GitHub Documentation Status codecov PyPI PyPI Downloads

Lightning Pose is an end-to-end package designed for robust multi-view and single-view animal pose estimation using advanced transformer architectures. It leverages Multi-View Transformers and simulated occlusions to learn geometric relationships between views, resulting in strong performance on occlusions (Aharon, Whiteway et al., 2026). For single-view datasets it leverages temporal context and unsupervised losses for strong performance in challenging scenarios (Biderman, Whiteway et al. 2024, Nature Methods). It has a rich GUI that supports the end-to-end workflow: labeling, model management, and evaluation.

Below is a quick start guide; see the full documentation here.

Installation

Lightning Pose requires a Linux or WSL environment with an NVIDIA GPU. It has been tested on Ubuntu 18.04, 22.04, and 24.04 with Python versions 3.10-3.12.

For users without access to a local NVIDIA GPU, it is highly recommended to use the Lightning AI cloud environment, which provides a persistent, browser-based "Studio" with on-demand access to powerful GPUs and pre-configured CUDA environments.

Install dependencies:

sudo apt install ffmpeg

# Verify nvidia-driver with CUDA 12+
nvidia-smi

In a clean python virtual environment (conda or other virtual environment manager), run:

pip install lightning-pose lightning-pose-app

That's it! Installation should take 5-10 minutes depending on your internet connection. To run the app:

litpose run_app

Please see the installation guide for more detailed instructions, and feel free to reach out to us on Discord in case of any hiccups.

Getting Started

To get started with Lightning Pose, follow the guides on our documentation:

Note that model training time will depend heavily on dataset size and GPU resources. Fitting a typical backbone (ResNet-50 or ViT-Small) on ~200 labeled frames will take about 20 minutes on a T4 GPU. See the publications linked above for more thorough benchmarking of training and inference times.

Community

The Lightning Pose team also actively develops the Ensemble Kalman Smoother (EKS), a simple and performant post-processor that works with any pose estimation package including Lightning Pose, DeepLabCut, and SLEAP.

Lightning Pose is primarily maintained by Karan Sikka (Columbia University) and Matt Whiteway (Columbia University).

Lightning Pose is under active development and we welcome community contributions. Whether you want to implement some of your own ideas or help out with our development roadmap, please get in touch with us on Discord (see contributing guidelines here).

Funding

We are grateful for support from the following:

Metadata

Release files for lightning-pose 2.4.4

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

Source distribution (sdist)

Source distribution for lightning-pose 2.4.4
File Size Uploaded Provenance Actions
lightning_pose-2.4.4.tar.gz 218.5 kB Without provenance Details for lightning_pose-2.4.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for lightning-pose 2.4.4
File Interpreter ABI Platform Actions
lightning_pose-2.4.4-py3-none-any.whl Python 3 none any Details for lightning_pose-2.4.4-py3-none-any.whl

Total release size: 488.6 kB

Release files / lightning_pose-2.4.4.tar.gz

Download URL lightning_pose-2.4.4.tar.gz
Size 218.5 kB
Tags Source
SHA-256 checksum
How to use checksums
8150d965a71038b0af47cae0cf90a27693d3f2f29fdb9d47cd6ec5418a10e347
BLAKE2b-256 checksum
How to use checksums
7aa3372ec01e60e464ac9a6ecea901b18baa9e1598ed4f2f9d2cfe6b3a0edfe3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.5.1 CPython/3.11.17 Linux/7.0.0-1017-azure

Release files / lightning_pose-2.4.4-py3-none-any.whl

Download URL lightning_pose-2.4.4-py3-none-any.whl
Size 270.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ce180ae22b3f9653810af77dff0a2d5f44e41954539212ae6f16f3d312bdf421
BLAKE2b-256 checksum
How to use checksums
62ecb6eeeb5f952f1787e6a269ec6d995469392bdad471ca5e96fd3ffee46092
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.5.1 CPython/3.11.17 Linux/7.0.0-1017-azure

Security for lightning-pose 2.4.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.4.4 This release

2 release files No provenance

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