DeepLabCut /DeepLabCut

Official implementation of DeepLabCut: Markerless pose estimation of user-defined features with deep learning for all animals incl. humans

★ 5,824⑂ 1,797👁 119⑃ 1,358● 2,197▤ 63
PythonLGPL-3.0Created 2018-03-26deeplabcut.org
下载:v3.0.2v3.0.2 ↓3.0.22026-09-23
+2
日增长
5,824
stars
1,797
forks
119
watchers
1,358
prs
2,197
issues
63
releases

README

📚Documentation |
🛠️ Installation |
🌎 Home Page |
🐿🐴🐁🐘🐆 Model Zoo |
🚨 News |
🪲 Reporting Issues


🫶 Getting Assistance |
∞ DeepLabCut Online Course |
📝 Publications |
👩🏾‍💻👨‍💻 DeepLabCut AI Residency


!Version
















 Welcome! 👋

DeepLabCut™️ is a toolbox for state-of-the-art markerless pose estimation of animals performing various behaviors. As long as you can see (label) what you want to track, you can use this toolbox, as it is animal and object agnostic. Read a short development and application summary below.

 Installation

Please click the link above for all the information you need to get started! Please note that currently we support only Python 3.10+ (see conda files for guidance).

 Quick start

Developers Stable Release: very quick start (Python 3.10+ required) to install
DeepLabCut with the PyTorch engine

- [1] Install PyTorch (install and then select the desired
CUDA version if you want to use a GPU): pip install torch torchvision.
Or as an example for GPU support (please check pytorch docs to get the perfect version for your CUDA):
bash
conda install pytorch cudatoolkit=11.3 -c pytorch

- [2] Then, install DeepLabCut (with all functions + the GUI):

bash
pip install --pre  "deeplabcut[gui]"

or pip install  --pre "deeplabcut" (headless
version with PyTorch)!

To use the TensorFlow (TF) engine: you'll need to run pip install "deeplabcut[gui,tf]" or pip install "deeplabcut[tf]" (headless version with TF). Alternatively, we also offer more targeted optional TensorFlow installs for specific CUDA setups, e.g. deeplabcut[tf-cu11] or deeplabcut[tf-cu12]. Please refer to our installation instructions for more detailed information on Python version, CUDA compatibility, etc.
We aim to deprecate the tensorflow backend in version 3.2 (release date TBD).



 Documentation: The DeepLabCut Process

Our docs walk you through using DeepLabCut, and key API points. For an overview of the toolbox and workflow for project management, see our step-by-step at Nature Protocols paper.








 Code demo

🐭 Pose tracking of single animals demo 

See more demos here.
We provide data and several Jupyter Notebooks, walking you through a demo dataset to test your installation, and another to run DeepLabCut from the start on your own data.
We also show how to use the code in Docker, and on Google Colab.

 Why use DeepLabCut?

DeepLabCut continues to be actively maintained and we strive to provide a user-friendly GUI and API for computer vision researchers and life scientists alike. This means we integrate state-of-the-art models and frameworks, while providing our "best-guess" defaults for life scientists.
We highly encourage you to read our papers to get a better understanding of what to use and how to modify the models for your setting.

 Performance 🔥

In general, we provide all the tooling for you to train and use custom models with various high-performance backbones.

 Pretrained Models

We also provide two foundation pretrained animal models: Super

Top issues

Latest release

v3.0.2 v3.0.2 2026-09-23
DeepLabCut 3.0.2


DeepLabCut 3.0.2 is a patch release bringing several PyTorch workflows fixes,
improved config handling and export reliability, broadened compatibility for newer
NumPy / Matplotlib versions, and adding a machine-readable docs/API index for
agent-assisted interactions with the library.


 Highlights

- Forward-compatibility work for NumPy 2, pandas 3 CoW, and Matplotlib 3.9,
  including releasing core NumPy / Matplotlib upper bounds (3420, 3498,
  3502, 3508, 3499, 3445, 3394).
- More reliable COCO training: model_cfg.metadata is authoritative, with
  fail-fast 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON