How to Install pydantic-settings in Python
Settings management using Pydantic
pip install pydantic-settings
What is pydantic-settings?
Settings management using Pydantic
Quick Start
Minimal example to get started with pydantic-settings:
import pydantic_settings
print(pydantic_settings.__version__)Installation
pip (standard)
pip install pydantic-settingsVirtual environment (recommended)
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install pydantic-settingspip3
pip3 install pydantic-settingsconda
conda install -c conda-forge pydantic-settingsPoetry
poetry add pydantic-settingsDependencies
Installing pydantic-settings will also install these packages:
Verify the Installation
After installing, confirm the package is available:
python -c "import pydantic_settings; print(pydantic_settings.__version__)"If this prints a version number, installation succeeded. If you see a ModuleNotFoundError, see the errors section below.
Installation Errors
Common errors when installing pydantic-settings with pip.
ModuleNotFoundError: No module named 'pydantic_settings'
Cause: The package is not installed in the current Python environment.
Fix: Run pip install pydantic-settings. If using a virtual environment, ensure it is activated first.
ModuleNotFoundError: No module named 'pydantic_settings' (installed but still failing)
Cause: pip installed the package into a different Python than the one running your script.
Fix: Use python -m pip install pydantic-settings to install into the interpreter you are running.
ImportError: cannot import name 'X' from 'pydantic_settings'
Cause: The function or class does not exist in the installed version.
Fix: Check the version with pip show pydantic-settings and upgrade with pip install --upgrade pydantic-settings.
pip: command not found
Cause: pip is not in PATH or Python was not added to PATH during installation.
Fix: Try python -m pip install pydantic-settings. On macOS/Linux try pip3.
PermissionError: [Errno 13] Permission denied
Cause: No write access to the system Python package directory.
Fix: Use a virtual environment, or add --user: pip install --user pydantic-settings
SSL: CERTIFICATE_VERIFY_FAILED
Cause: pip cannot verify PyPI's SSL certificate — common behind corporate proxies.
Fix: Try: pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org pydantic-settings
Recent Releases
| Version | Released |
|---|---|
2.13.1 latest |
2026-02-19 |
2.13.0 |
2026-02-15 |
2.12.0 |
2025-11-10 |
2.11.0 |
2025-09-24 |
2.10.1 |
2025-06-24 |
Manage pydantic-settings
Upgrade to latest version
pip install --upgrade pydantic-settingsInstall a specific version
pip install pydantic-settings==2.13.1Uninstall
pip uninstall pydantic-settingsCheck what is installed
pip show pydantic-settings