---
id: dynaconf
version: "3.3.5"
license: MIT
license_treatment: permissive
maintenance: active
---

# dynaconf — The dynamic configurator for your Python Project

License: permissive · Maintenance: active · Downloads: 7.2M/mo

## What it is and what it does

Dynaconf is a configuration management library that centralizes application settings across multiple file formats (toml, yaml, json, ini, py) and environment layers. It reads from settings files, secrets files, and environment variables—with environment variables taking precedence—allowing the same codebase to adapt to development, testing, and production without code changes. The library handles type casting automatically, supports nested key access via dot notation or bracket syntax, and includes a CLI for initialization, validation, and export.

The package is designed around the 12-factor application pattern, making it especially useful for teams that need to separate configuration from code and protect sensitive data. It includes built-in extensions for Django and Flask, optional integration with Hashicorp Vault and Redis for centralized secrets storage, and schema validation for catching configuration errors early. With no runtime dependencies, it installs cleanly and integrates into existing projects with minimal friction.

Use it for:

- Manage database credentials, API keys, and other secrets separately from application code using .secrets files and environment variables
- Configure the same application for development, testing, and production environments using layered settings files without code changes
- Validate configuration schemas at startup to catch missing or malformed settings before the application runs
- Override specific settings per execution using environment variables without editing files
- Integrate with Django or Flask projects to centralize settings management across web framework configurations
- Store and retrieve secrets from Hashicorp Vault or Redis for teams requiring centralized secrets management

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Dynaconf manages application configuration across multiple file formats and environments, supporting environment variable overrides, secrets protection, and integration with Django and Flask.

Yes. Dynaconf is actively maintained, has no runtime dependencies, supports current Python versions, and solves a common problem—separating configuration from code—in a straightforward way. The MIT license imposes no restrictions. Use it if you need environment-based configuration, secrets protection, or multi-format settings support; skip it only if your project's configuration needs are minimal.

## Install

pip install dynaconf
uv add dynaconf
poetry add dynaconf

## Installing dynaconf

Before you install: Low friction installation with no runtime dependencies. Active maintenance—last release 9 days ago, repository at 4320 stars, supporting current Python versions (3.10–3.14).

License in practice: MIT license (permissive) places no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

pip install dynaconf

from dynaconf import Dynaconf

settings = Dynaconf(
    envvar_prefix="DYNACONF",
    settings_files=['settings.toml', '.secrets.toml']
)

print(settings.username)
print(settings['database.name'])

Verify before relying:

- Whether Vault and Redis integration require additional system setup or dependencies beyond the base package
- Performance characteristics when managing large configuration files or deeply nested structures
- Validation schema capabilities and whether they cover common use cases like type coercion and range constraints

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 7.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python configuration management, environment-based settings, secrets management python, dotenv alternative, multi-environment config, settings validation python, vault integration config, configuration-management, secrets-handling, environment-variables

[View on SkillFed](https://skillfed.io/packages/dynaconf) · [View on PyPI](https://pypi.org/project/dynaconf/)