DeepLabCut-Live-GUI

GUI to run DeepLabCut-Live on a video feed, preview and record from one or multiple cameras, and optionally record external timestamps and processor outputs.

Update

The GUI has been modernized and is now built with PySide6 (Qt) (replacing tkinter).

The new interface supports multi-camera preview with a tiled display, PyTorch models, and features improved interactive workflows for experimental use.

Documentation

Find the full documentation at the DeepLabCut docs website

System requirements (quick summary)

• Python 3.10, 3.11 or 3.12
• One inference backend (choose at least one):
  • PyTorch (recommended for best performance & compatibility)
  • TensorFlow (for backwards compatibility with existing models; Windows installs are no longer available for Python > 3.10)
• A supported camera backend (OpenCV webcams by default; additional backends supported)

Installation

deeplabcut-live-gui 2.0 is now available on PyPI.

To get the latest version, please follow the instructions below.

Option A — Install with uv

1) Create & activate a new virtual environment

uv venv -p 3.12 dlclivegui

# Linux/macOS:
source dlclivegui/bin/activate

# Windows (Command Prompt):
.\dlclivegui\Scripts\activate.bat

# Windows (PowerShell):
.\dlclivegui\Scripts\Activate.ps1

2) Choose inference backend and install

You may install PyTorch or TensorFlow extras (or both), but you must choose at least one to run inference.

• PyTorch (recommended):

uv pip install --pre deeplabcut-live-gui[pytorch]

• TensorFlow (backwards compatibility):

uv pip install --pre deeplabcut-live-gui[tf]

---

Option B — Install with mamba / conda

1) Create & activate a new conda environment

conda create -n dlclivegui python=3.12 # or mamba
conda activate dlclivegui

2) Install with your inference backend

• PyTorch (recommended):

pip install --pre deeplabcut-live-gui[pytorch]

• TensorFlow:

pip install --pre deeplabcut-live-gui[tf]

Run the application

After installation, start the application with:

dlclivegui # in conda/mamba

# OR:
uv run dlclivegui

Typical workflow

The new GUI supports one or more cameras.

Typical workflow:

1. Configure Cameras (choose backend and devices)
   • Adjust camera settings (serial, exposure, ROI/cropping, etc.)
2. Start Preview
   • Adjust visualization settings (keypoint color map, bounding boxes, etc.)
3. Start inference
   • Choose a DeepLabCut Live model
   • Choose which camera to run inference on (currently one at a time)
4. Start recording
   • Adjust recording settings (codec, output format, etc.)
   • Record video and timestamps to organized session folders

Current limitations

• Pose inference runs on one selected camera at a time (even in multi-camera mode)
• Camera features support and availability depends on backend capabilities and hardware
  • OpenCV controls for resolution/FPS are best-effort and device-driver dependent
• DeepLabCut-Live models must be exported and compatible with the chosen backend
• Performance depends on resolution, frame rate, GPU availability, and codec choice

---

References

If you use this code, we kindly ask you to please cite:

• Kane et al., eLife 2020
  • If preferred, see the Preprint

---

Contributing / Feedback

This project is under active development — feedback from real experimental use is highly valued.

Please report issues, suggest features, or contribute here on GitHub.