pypi i sleap


A deep learning framework for multi-animal pose tracking.

by talmolab

1.2.6 (see all)License:BSD 3-Clause License
pypi i sleap

|CI| |Coverage| |Documentation| |Downloads| |Stable version| |Latest version|

.. |CI| image:: :target: :alt: Continuous integration status

.. |Coverage| image:: :target: :alt: Coverage

.. |Documentation| image:: :target: :alt: Documentation

.. |Downloads| image:: :target: :alt: Downloads

.. |Stable version| image:: :target: :alt: Stable version

.. |Latest version| image:: :target: :alt: Latest version

.. start-inclusion-marker-do-not-remove

Social LEAP Estimates Animal Poses (SLEAP)

.. image:: :width: 600px

SLEAP is an open source deep-learning based framework for multi-animal pose tracking. It can be used to track any type or number of animals and includes an advanced labeling/training GUI for active learning and proofreading.


  • Easy, one-line installation with support for all OSes
  • Purpose-built GUI and human-in-the-loop workflow for rapidly labeling large datasets
  • Single- and multi-animal pose estimation with top-down and bottom-up training strategies
  • State-of-the-art pretrained and customizable neural network architectures that deliver accurate predictions with very few labels
  • Fast training: 15 to 60 mins on a single GPU for a typical dataset
  • Fast inference: up to 600+ FPS for batch, <10ms latency for realtime
  • Support for remote training/inference workflow (for using SLEAP without GPUs)
  • Flexible developer API for building integrated apps and customization

Get some SLEAP

SLEAP is installed as a Python package. We strongly recommend using Miniconda <https://>_ to install SLEAP in its own environment.

You can find the latest version of SLEAP in the Releases <>_ page.

Quick install ^^^^^^^^^^^^^ conda (Windows/Linux/GPU):

.. code-block:: bash

conda create -y -n sleap -c sleap -c nvidia -c conda-forge sleap

pip (any OS):

.. code-block:: bash

pip install sleap

See the docs for full installation instructions <>_.

Learn to SLEAP

  • Learn step-by-step: Tutorial <>_
  • Learn more advanced usage: Guides <> and Notebooks <>
  • Learn by watching: MIT CBMM Tutorial <>_
  • Learn by reading: Paper (Pereira et al., Nature Methods, 2022) <>_ and Review on behavioral quantification (Pereira et al., Nature Neuroscience, 2020) <>
  • Learn from others: Discussions on Github <>_


SLEAP is the successor to the single-animal pose estimation software LEAP <> (Pereira et al., Nature Methods, 2019 <>).

If you use SLEAP in your research, please cite:

T.D. Pereira, N. Tabris, A. Matsliah, D. M. Turner, J. Li, S. Ravindranath, E. S. Papadoyannis, E. Normand, D. S. Deutsch, Z. Y. Wang, G. C. McKenzie-Smith, C. C. Mitelut, M. D. Castro, J. DUva, M. Kislin, D. H. Sanes, S. D. Kocher, S. S-H, A. L. Falkner, J. W. Shaevitz, and M. Murthy. `Sleap: A deep learning system for multi-animal pose tracking <>`__. *Nature Methods*, 19(4), 2022


.. code-block::

@ARTICLE{Pereira2022sleap, title={SLEAP: A deep learning system for multi-animal pose tracking}, author={Pereira, Talmo D and Tabris, Nathaniel and Matsliah, Arie and Turner, David M and Li, Junyu and Ravindranath, Shruthi and Papadoyannis, Eleni S and Normand, Edna and Deutsch, David S and Wang, Z. Yan and McKenzie-Smith, Grace C and Mitelut, Catalin C and Castro, Marielisa Diez and D'Uva, John and Kislin, Mikhail and Sanes, Dan H and Kocher, Sarah D and Samuel S-H and Falkner, Annegret L and Shaevitz, Joshua W and Murthy, Mala}, journal={Nature Methods}, volume={19}, number={4}, year={2022}, publisher={Nature Publishing Group} } }


Follow @talmop <>_ on Twitter for news and updates!

Technical issue with the software?

  1. Check the Help page <>_.
  2. Ask the community via discussions on Github <>_.
  3. Search the issues on GitHub <>_ or open a new one.

General inquiries? Reach out to

.. _Contributors:


  • Talmo Pereira, Salk Institute for Biological Studies
  • Liezl Maree, Salk Institute for Biological Studies
  • Arlo Sheridan, Salk Institute for Biological Studies
  • Arie Matsliah, Princeton Neuroscience Institute, Princeton University
  • Nat Tabris, Princeton Neuroscience Institute, Princeton University
  • David Turner, Research Computing and Princeton Neuroscience Institute, Princeton University
  • Joshua Shaevitz, Physics and Lewis-Sigler Institute, Princeton University
  • Mala Murthy, Princeton Neuroscience Institute, Princeton University

SLEAP was created in the Murthy <> and Shaevitz <> labs at the Princeton Neuroscience Institute <>_ at Princeton University.

SLEAP is currently being developed and maintained in the Talmo Lab <> at the Salk Institute for Biological Studies <>, in collaboration with the Murthy and Shaevitz labs at Princeton University.

This work was made possible through our funding sources, including:

  • NIH BRAIN Initiative R01 NS104899
  • Princeton Innovation Accelerator Fund


SLEAP is released under a Clear BSD License <>_ and is intended for research/academic use only. For commercial use, please contact: Laurie Tzodikov (Assistant Director, Office of Technology Licensing), Princeton University, 609-258-7256.

.. end-inclusion-marker-do-not-remove

  • Documentation Homepage <>_
  • Overview <>_
  • Installation <>_
  • Tutorial <>_
  • Guides <>_
  • Notebooks <>_
  • Developer API <>_
  • Help <>_

GitHub Stars



3mos ago








19d ago
22d ago
2mos ago
3mos ago
No alternatives found
No tutorials found
Add a tutorial