version 3.0.3

deruyter92 · Nov 11, 2026 · Nov 14, 2026 · f3c68cf7d82a9b4b4195706aefda6673d60e183f
commit f3c68cf7d82a9b4b4195706aefda6673d60e183f
diff --git a/changelog/3_0_3/v3_0_3.md b/changelog/3_0_3/v3_0_3.md
@@ -0,0 +1,63 @@
+# DeepLabCut 3.0.3
+
+DeepLabCut 3.0.3 is a patch release with better handling of undetected poses along inference and security-related dependency bumps, as well as adding more flexibility to PyTorch data loading.
+
+## Highlights
+
+- New `dataloader_kwargs` in `train_settings` to configure the PyTorch `DataLoader` (#3550, #3576).
+- Top-down inference no longer skips frames without detections; warn about unreadable videos (#3488).
+- Fix wrong multi-animal tracking when an ellipse fit fails on one animal (#3544).
+- Fix wrong starting frame in k-means frame extraction for consecutive indices (#3531).
+- Fix GUI freeze when showing trajectory plots in Analyze Videos (#3466).
+
+## Important changes
+
+### Train settings: `dataloader_kwargs` (#3550, #3576)
+
+`TrainSettingsConfig` now has a `dataloader_kwargs` field for forwarding additional parameters to the PyTorch DataLoader (e.g. `persistent_workers`, `prefetch_factor`).
+Please see [related documentation](https://github.com/DeepLabCut/DeepLabCut/blob/main/docs/pytorch/pytorch_config.md#train-settings).
+
+> [!NOTE]
+> `pytorch_config.yaml` only contains `dataloader_kwargs` when set manually. Configurations that leave it unset can still be used in <=3.0.2; configurations that did set it cannot, unless the field is removed.
+
+## Features and enhancements
+
+- #3550, #3576 — Expose PyTorch `DataLoader` arguments in `TrainSettingsConfig`; omit the field from saved configs when unset.
+- #3551 — Update `AGENTS.md` for AI-contribution requirements.
+- #3530, #3533 — Update napari documentation.
+- #3398 — Add a Cookbook recipe on fish swimming kinematics (community contribution).
+
+## Bug fixes and tests
+
+- #3544 — Fix wrong multi-animal tracking in `SORTEllipse.track` on unfitted ellipses.
+- #3488 — Fix skipped zero detection frames in async top-down inference and manage unreadable videos.
+- #3466 — Fix GUI freeze when showing trajectory plots in Analyze Videos; plots are now shown after the run.
+- #3557 — Fix missing `load_scheduler_state_dict` field in `RunnerConfig`.
+- #3535 — Fix GUI uv package upgrades.
+- #3531 — Fix wrong starting frame read in `KmeansbasedFrameselectioncv2` for consecutive indices.
+- #3520 — Fix test IDs drift between pytest discovery and runs.
+- #3564, #3565 — Fix `_meta.pickle` portability across OSes.
+- #3526, #3527 — Add version-aware known-defect tests for `labeled-data` enumeration.
+
+## Dependencies and security
+
+- [emSign/eMudhra CA incident](https://discuss.python.org/t/information-for-python-users-regarding-emudhra-emsign-ca-certificate-security-incident/109576):
+  * #3560 — Bump uv 0.10.10 → 0.13.4 and certifi 2026.4.22 → 2026.10.19.
+  * #3561 — Update the Dockerfile accordingly and to upgrade ca-certificates.
+- #3576 — Require pydantic >=2.12 (previously >=2); lockfile: pydantic 2.13.4 → 2.14.2, pydantic-core 2.46.4 → 2.50.2, typing-extensions 4.15.0 → 4.16.0, typing-inspection 0.4.2 → 0.4.4.
+- #3542 — Bump gitpython 3.1.59 → 3.1.62.
+- #3540 — Bump tornado 6.5.8 → 6.5.9.
+- #3523 — Bump anyio 4.13.0 → 4.14.2.
+- #3522 — Bump soupsieve 2.8.4 → 2.9.
+- #3541 — Bump urllib3 2.7.0 → 2.8.0.
+- #3552 — Bump werkzeug 3.1.8 → 3.1.9.
+- #3563 — Bump pillow 12.2.0 → 12.3.0.
+
+## Code removal
+
+- #3431 — Remove the empty benchmark module of `pose_estimation_pytorch`.
+- #3543 — Remove unused `adapt_labeled_data_to_new_project` from `utils.conversioncode`.
+
+
+
+Please let us know if you face any issues with this release, we appreciate any issues or reports!
diff --git a/deeplabcut/version.py b/deeplabcut/version.py
@@ -9,5 +9,5 @@
 # Licensed under GNU Lesser General Public License v3.0
 #
 
-__version__ = "3.0.2"
+__version__ = "3.0.3"
 VERSION = __version__
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ requires = [ "setuptools>=61" ]
 
 [project]
 name = "deeplabcut"
-version = "3.0.2"
+version = "3.0.3"
 description = "Markerless pose-estimation of user-defined features with deep learning"
 readme = { file = "README.md", content-type = "text/markdown" }
 keywords = [

diff --git a/uv.lock b/uv.lock