🐍 Python SDK v2.4.0

Configuration Management
for Python Developers

Type-safe, async-native, and Pydantic-ready. Manage app configs across environments with zero downtime.

Get Started API Docs

pip install app-config-json

Quickstart

Up and Running in 60 Seconds

Initialize the client, fetch your config, and start shipping.

main.py

from app_config import ConfigClient, ConfigModel
from pydantic import BaseModel, Field

class AppSettings(BaseModel):
    db_url: str = Field(..., alias="DATABASE_URL")
    cache_ttl: int = 300
    debug_mode: bool = False

async def main():
    client = ConfigClient(api_key="ak_live_...")
    settings = await client.get_config(
        environment="production",
        model=AppSettings
    )
    print(settings.db_url)  # 🔒 Type-safe & validated

import asyncio
asyncio.run(main())
                

terminal

$ python main.py
postgresql://user:pass@db.prod:5432/appdb

✅ Config validated with Pydantic
✅ Fetched from edge CDN (42ms)
✅ Auto-cached & type-hinted
                

Why Python?

Built for Modern Python Stacks

Designed alongside FastAPI, Django, and Celero workflows.

⚡

Async-First Architecture

Native async/await support. Integrates seamlessly with FastAPI, aiohttp, and Quart without blocking the event loop.

🧩

Pydantic Validation

Drop your Pydantic models directly into get_config(). Automatic parsing, validation, and error handling out of the box.

🔄

Hot-Reload & Webhooks

Receive live config updates via WebSocket or HTTP webhooks. Restart nothing, deploy features instantly.

📦

Smart Caching

L2/L3 cache layers with TTL controls, stale-while-revalidate, and offline fallback for edge/lambda deployments.

API Reference

Core Client Methods

Everything you need to interact with the App Config.json platform.

Method	Description	Returns
async get_config(env, model=None)	Fetches configuration for the specified environment. Validates against optional Pydantic model.	BaseModel \| dict
async watch(env, callback)	Opens a persistent WebSocket connection. Triggers callback on live config updates.	async_iterator
get_fallback(env, key, default=None)	Sync-safe fallback resolver for synchronous contexts (Django, Celery).	Any
validate_schema(schema_dict)	Validates a config payload against your registered JSON schema. Returns detailed errors.	ValidationResult

Configuration Managementfor Python Developers