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
+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
#35790% GPU utilization; `torch.cuda.is_available()` reports `true`6 comments · 2026-11-04#2887Unsolicited advice on packaging and compatibility5 comments · 2025-02-17#3462DLC Freezing Issue4 comments · 2026-08-25#3281[FR] Add an option to add addtitional individuals to multianimal model4 comments · 2026-04-09#3585validation errors for ProjectConfig while calibrating for 3D project3 comments · 2026-11-12#3562Cannot create labelled videos on Windows from videos analyzed on Linux3 comments · 2026-10-22#3381Update (or remove) command line interface3 comments · 2026-06-24#3556Extra inputs are not permitted2 comments · 2026-10-16
Latest release
v3.0.2 v3.0.2 2026-09-23DeepLabCut 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