pydantic/pydantic-settings

Health v2 · maintenance only

Adoption not part of the score

1433 stars · 179 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

pydantic-settings is a Python library for managing application settings and configuration using Pydantic models. It loads type-validated settings from environment variables, .env files, and secrets directories, with support for aliases, defaults, and manual overrides.

Use cases

• load app configuration from environment variables with type validation
• manage settings via .env files in a python project
• validate environment variables against a typed config class
• override settings in unit tests
• load secrets from files or directories
• define a 12-factor app configuration in python

When to choose

• you already use Pydantic and want validated, type-hinted configuration
• you need settings sourced from env vars, dotenv files, or secrets directories
• you want clear validation errors pointing at misconfigured environment values

When to avoid

• you need a full configuration system with dynamic reload or remote config stores
• your project doesn't use Python or the Pydantic ecosystem
• you only need simple key-value parsing without validation

Facets

library · maturity active

configuration-management serialization developer-tools developer-tools backend web-development python cross-platform pydantic environment-variables settings dotenv type-hints config-validation secrets-files

Member repositories

For agents

markdown · JSON · MCP: product_card(name="pydantic/pydantic-settings")