---
id: pydantic-settings-azure-app-configuration
version: "1.1.0"
license: unclear
license_treatment: unclear
maintenance: aging
---

# pydantic-settings-azure-app-configuration — Azure App Configuration setting source for pydantic-settings

License: unclear · Maintenance: aging · Downloads: 387.4K/mo

## What it is and what it does

This package integrates Azure App Configuration and Azure Key Vault with pydantic-settings, allowing you to define application settings as pydantic models and populate them directly from Azure services. It acts as a custom settings source that plugs into pydantic-settings' `settings_customise_sources` hook, so configuration values flow into your BaseSettings classes alongside environment variables and other sources.

The package supports filtering configuration by key prefix, trimming that prefix from resulting field names, and transparently resolving references to secrets stored in Key Vault. It requires Azure credentials and supports nested models through a configurable delimiter.

Use it for:

- Centralize application configuration in Azure App Configuration while keeping pydantic validation and type safety.
- Retrieve database passwords and API keys from Azure Key Vault without hardcoding or managing separate secret files.
- Multi-tenant or multi-environment deployments where different instances load config by key prefix from a shared store.
- Migrate from environment-variable-based config to a managed Azure service while preserving pydantic's nested model patterns.
- Use Entra ID role-based access control to secure config access without shared credentials.

## Worth the install?

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

Loads application configuration and secrets from Azure App Configuration and Azure Key Vault into pydantic-settings models, with support for key filtering, prefix trimming, and nested configuration.

Yes, if you are already committed to Azure and pydantic-settings. The package has low install friction and no known vulnerabilities. However, the aging maintenance status and unclear license pose moderate risk for production use. Verify the license explicitly and assess whether the limited community support is acceptable for your deployment model.

## Install

pip install pydantic-settings-azure-app-configuration
uv add pydantic-settings-azure-app-configuration
poetry add pydantic-settings-azure-app-configuration

## Installing pydantic-settings-azure-app-configuration

Before you install: Low install friction with a pure-Python wheel. Maintenance status is aging—last commit was 2025-09-09 with only 3 stars, suggesting limited community adoption and uncertain long-term support.

License in practice: License treatment is unclear; no SPDX identifier or raw license text is declared in the package metadata. Verify the actual license before using in proprietary or GPL-sensitive contexts.

Quickstart:

from azure.identity import DefaultAzureCredential
from pydantic_settings import BaseSettings
from pydantic_settings_azure_app_configuration.source import AzureAppConfigurationSettingsSource

class MySettings(BaseSettings):
    api_key: str
    @classmethod
    def settings_customise_sources(cls, settings_cls, init_settings, env_settings, dotenv_settings, file_secret_settings):
        credential = DefaultAzureCredential()
        azure_source = AzureAppConfigurationSettingsSource(settings_cls, lambda opts: opts.connect_with_url(os.environ["AZURE_APP_CONFIGURATION_URL"], credential))
        return (init_settings, env_settings, dotenv_settings, file_secret_settings, azure_source)

Requires Python >=3.11; Azure credentials and AZURE_APP_CONFIGURATION_URL environment variable must be configured.

Verify before relying:

- Whether the package is actively maintained or in maintenance-only mode given the aging status and low star count.
- The actual license under which the package is distributed, since metadata declares none.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 387.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

azure app configuration pydantic, pydantic settings azure, load config from azure, azure key vault secrets pydantic, azure app configuration settings source, pydantic azure integration, azure configuration management, azure-integration, configuration-management, secrets-management

[View on SkillFed](https://skillfed.io/packages/pydantic-settings-azure-app-configuration) · [View on PyPI](https://pypi.org/project/pydantic-settings-azure-app-configuration/)