This PR should consolidate the new version before release, and can be merged after merging the following PRs that should be included:

• Refactor ctd_conditions / conditions_provider + add ConditionsConfig + fix InferenceConfig #3387
• Fix PySide6 stylesheet usage #3371
• Docs: add CSPNext to pytorch architectures, minor formatting #3413
• Miscellaneous imports and code fixes #3411
• GUI: Fix redundant signal calls, streamline path selections #3395
• GUI: Config validation errors handler dialog & layout fixes #3397
• Harden path-handling after pathlib migration #3421
• Update deprecation markers (3.1 -> 3.0.1) #3422
• 818668b fix misplaced style.qss (merge-conflict)

See draft changelog below:

DeepLabCut 3.0.1 - a stability release with a major documentation overhaul and a new structured configuration system.

Highlights

• Comprehensive documentation audit — The user guide has been thoroughly reviewed, updated, and improved. Please check out:

  • Our updated user guide, which is restructured for better readability and updated to reflect the latest API and features.
  • Our brand-new developer documentation site, which provides full API references, architecture guides, and developer onboarding material.

• Structured & validated configurations — The config system has been migrated to typed Pydantic models. Existing config.yaml files remain fully compatible, but configs are now schema-validated on load with clear error messages for invalid entries. Some user-benefits include:

  • ProjectConfig: load and save your config.yaml with full schema validation — typos, wrong types, or invalid values are caught immediately with clear error messages.
  • Pretty-printing: call cfg.print() or pretty_print(cfg) to inspect any config in a readable tree.
  • Change-tracking: DLCVersionedConfig tracks which fields have been modified since the config was loaded from YAML, so when saving back to disk, log_changes() can report exactly what was changed.
  • Dict-like compatibility: existing code that accesses config keys like a dict still works.
  • Auto-aliasing of old field names: renamed keys are silently mapped, so older config files load without manual edits.

Summarized Changelog

• Update deeplabcut-docker - version 0.1.0 by @deruyter92 in Update deeplabcut-docker - version 0.1.0 #3345
• Fix NaN handling in PredictKeypointIdentities postprocessor by @deruyter92 in Fix NaN handling in PredictKeypointIdentities postprocessor #3378
• Migration to structured and validated configs by @deruyter92 in Migration to structured and validated configs #3198
• Remove unused create_folder function from utils.py by @juan-cobos in Remove unused create_folder function from utils.py #3359
• Refactor VideoProcessor class by @C-Achard in Refactor VideoProcessor class #3358
• Prepare migration to pandas 3.0 by @deruyter92 in Prepare migration to pandas 3.0 #3360
• Fix SkeletonBuilder initialization from GUI by @C-Achard in Fix SkeletonBuilder initialization from GUI #3380
• Add GUI extra in auto-updater; support uv by @C-Achard in Add GUI extra in auto-updater; support uv #3346
• Docs audit [April 2026]: Full version by @C-Achard in Docs audit [April 2026]: Full version #3341
• Migrate to pathlib.Path instead of str (first phase) by @deruyter92 in Migrate to pathlib.Path instead of str (first phase) #3350
• Bump idna from 3.13 to 3.15 by @dependabot[bot] in Bump idna from 3.13 to 3.15 #3337
• CI: Introduce functional scripts dependencies in CI test selection by @C-Achard in CI: Introduce functional scripts dependencies in CI test selection #3396
• Bump tornado from 6.5.5 to 6.5.7 by @dependabot[bot] in Bump tornado from 6.5.5 to 6.5.7 #3373
• Docs audit [April 2026]: Add dev docs by @deruyter92 in Docs audit [April 2026]: Add dev docs #3336
• Docs: Add links to dev docs in main user guide by @C-Achard in Docs: Add links to dev docs in main user guide #3412
• Bump msgpack from 1.1.2 to 1.2.1 by @dependabot[bot] in Bump msgpack from 1.1.2 to 1.2.1 #3377
• Bump soupsieve from 2.8.3 to 2.8.4 by @dependabot[bot] in Bump soupsieve from 2.8.3 to 2.8.4 #3388
• Docs: add CSPNext to pytorch architectures, minor formatting by @C-Achard in Docs: add CSPNext to pytorch architectures, minor formatting #3413
• Miscellaneous imports and code fixes by @C-Achard in Miscellaneous imports and code fixes #3411
• GUI: Fix redundant signal calls, streamline path selections by @C-Achard in GUI: Fix redundant signal calls, streamline path selections #3395
• Fix PySide6 stylesheet usage by @C-Achard in Fix PySide6 stylesheet usage #3371
• Refactor ctd_conditions / conditions_provider + add ConditionsConfig + fix InferenceConfig by @deruyter92 in Refactor ctd_conditions / conditions_provider + add ConditionsConfig + fix InferenceConfig #3387
• bump torch to version 2.13 (update uv.lock only) by @deruyter92 in bump torch to version 2.13 (update uv.lock only) #3400
• minor follow-up adjustments for config GUI validation by @deruyter92 in minor follow-up adjustments for config GUI validation #3399

Full Changelog: v3.0.0...v3.0.1