Change8

Pydantic Settings

Dev Tools

Settings management using pydantic

Latest: v2.12.08 releases3 breaking changesView on GitHub →

Release History

v2.12.0Breaking7 features
Nov 10, 2025

pydantic-settings 2.12 introduces enum kebab‑case support, a new NestedSecretsSettings source, updated source ordering, and adds Python 3.14 support while dropping Python 3.9.

v2.11.0Breaking6 fixes9 features
Sep 24, 2025

Pydantic Settings 2.11.0 introduces CLI serialization, root model support, and several enhancements, while removing automatic CLI argument parsing and disabling abbreviation handling, which may require migration steps.

2.10.11 fix
Jun 24, 2025

Version 2.10.1 addresses an UnboundLocalError in the internal field‑name replacement helper and cleans up a broken documentation reference.

2.10.08 fixes6 features
Jun 21, 2025

pydantic‑settings 2.10.0 adds YAML nested‑key loading, case‑sensitive secret manager options, a new `cli_shortcuts` flag, and numerous bug fixes and dependency updates.

v2.9.12 fixes
May 6, 2025

pydantic-settings 2.9.1 includes bug fixes for ConfigFileSourceMixing exposure and a typo in the GCP secret manager error message.

v2.9.0Breaking5 fixes10 features
Apr 18, 2025

pydantic-settings v2.9.0 drops Python 3.8, refactors the sources module, adds secret manager integrations and several CLI enhancements, while fixing documentation typos and updating the pydantic core dependency.

v2.8.13 fixes
Feb 27, 2025

Patch release 2.8.1 fixes init source alias resolution and reverts recent breaking changes to `BaseSettings.__init__`.

v2.8.02 fixes3 features
Feb 24, 2025

Version 2.8.0 adds optional/variadic CLI arguments, a new `env_nested_max_split` setting, async CLI methods, and fixes type‑signature and env‑delimiter issues.