django-cfg

Django-CFG

The Modern Django Framework for Enterprise Applications

Type-safe configuration • Real-time WebSockets • gRPC Streaming • OpenAPI client generation • AI-Native Docs • 8 Production Apps

Get Started • Live Demo • Documentation • MCP Server

What is Django-CFG?

Django-CFG is a next-generation Django framework that replaces settings.py with type-safe Pydantic v2 models. Catch configuration errors at startup, get full IDE autocomplete, and ship production-ready features in 30 seconds instead of weeks.

Why Django-CFG?

✅ Type-safe config - Pydantic v2 validation catches errors before deployment
✅ 90% less code - Replace 200+ line settings.py with 30 lines
✅ Typed API clients - Generate TypeScript / Python / Go clients from your DRF OpenAPI schema
✅ First-party analytics - Typed product events, goals, and ordered funnels without a third-party tracker
✅ Real-time WebSockets - Centrifugo integration included
✅ gRPC streaming - Bidirectional streaming with WebSocket bridge
✅ AI-native docs - First Django framework with MCP server for AI assistants
✅ Stripe payments - Checkout, webhooks, refunds out of the box (django-cfg[payments])
✅ 8 enterprise apps - Save 18+ months of development

Quick Start

One-Line Install

# macOS / Linux
curl -L https://djangocfg.com/install.sh | sh

# Windows (PowerShell)
powershell -c "iwr https://djangocfg.com/install.ps1 | iex"

Manual Install

pip install 'django-cfg[full]'
django-cfg create-project my_app
cd my_app/projects/django
poetry run python manage.py runserver

What you get instantly:

🎨 Django Admin (Unfold) → http://127.0.0.1:8000/admin/
📡 Real-time WebSockets → Live updates
🔌 Auto-generated API clients → TypeScript / Python / Go
🐳 Docker Ready → Production configs
🖥️ Electron App → Desktop template

→ Full Installation Guide

Configuration Example

Before: settings.py

# 200+ lines of untyped configuration
DEBUG = os.getenv('DEBUG', 'False') == 'True'  # ❌ Bug waiting to happen
DATABASE_PORT = os.getenv('DB_PORT', '5432')   # ❌ Still a string!

After: Django-CFG

from django_cfg import DjangoConfig, DatabaseConfig

class MyConfig(DjangoConfig):
    project_name: str = "My App"
    debug: bool = False  # ✅ Type-safe

    databases: dict[str, DatabaseConfig] = {
        "default": DatabaseConfig(
            name="${DB_NAME}",  # ✅ Validated at startup
            port=5432,          # ✅ Correct type
        )
    }

Full IDE autocomplete • Startup validation • Zero runtime errors

Features

🔒 Type-Safe Configuration

Pydantic v2 models replace error-prone settings.py - catch bugs before deployment.

🔌 Typed API Client Generation

Generate fully-typed TypeScript, Python, and Go clients straight from your DRF OpenAPI schema — no hand-written API code, no drift between backend and frontend.

python manage.py gen          # generate clients from the live OpenAPI schema
python manage.py gen --ts     # TypeScript only

📡 Real-Time WebSockets

Production-ready Centrifugo integration - live updates, notifications, presence tracking.

🌐 gRPC Microservices

Bidirectional streaming with automatic WebSocket bridge - perfect for real-time architectures.

💳 Payments Engine

Stripe-first payments app, production-lifted from a live SaaS: one-time checkout with idempotency, signature-verified webhooks with replay, refunds, reconciliation, and an in-memory fake provider for tests. Host couplings are config seams (owner model, fulfillment hook) — plug in your own billing objects.

from django_cfg import DjangoConfig, PaymentsConfig

class MyConfig(DjangoConfig):
    payments = PaymentsConfig(
        fulfillment_hook="apps.orders.hooks.activate_order",
    )

pip install 'django-cfg[payments]'   # adds the Stripe SDK

🤖 AI-Native Documentation

First Django framework with MCP server - AI assistants can access docs instantly.

📦 8 Enterprise Apps

User auth • Support tickets • Newsletter • CRM • AI agents • Knowledge base • Payments • Multi-site

Time saved: 18+ months of development

→ See All Features

What's Included

Backend:

Django 5.2+ with type-safe config
PostgreSQL, Redis, Centrifugo
gRPC server with streaming
8 production-ready apps
Stripe payments engine (checkout, webhooks, refunds)
AI agent framework
REST API with auto TypeScript generation

Admin:

Django Unfold for CRUD
JWT authentication
Dark theme by default
Constance-backed dynamic settings

DevOps:

Docker Compose setup
Traefik reverse proxy
Production-ready configs
Cloudflare integration

AI Features:

MCP server for AI assistants
Pydantic AI integration
Vector DB (ChromaDB)
RAG support

Documentation

Getting Started - Quick setup guide
Configuration - Type-safe config
API Generation - Typed TS/Python/Go clients
Real-Time - WebSockets setup
gRPC - Microservices
AI Agents - Automation
Built-in Apps - 8 enterprise apps

Community

🌐 djangocfg.com - Official website
🎯 Live Demo - See it in action
🐙 GitHub - Source code
💬 Discussions - Get help
📦 PyPI - Package repository

License

MIT License - Free for commercial use

Django-CFG - Modern Django framework with type-safe configuration, AI-native docs, typed API client generation, gRPC streaming, real-time WebSockets, and 8 production-ready apps.

Made with ❤️ for the Django community

Get Started • Live Demo • GitHub

Release files for django-cfg 2.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-cfg 2.3.1
File	Size	Uploaded
django_cfg-2.3.1.tar.gz	1.5 MB	Sep 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-cfg 2.3.1
File	Interpreter	ABI	Platform	Reset
django_cfg-2.3.1-py3-none-any.whl 2.1 MB Sep 10, 2026	Python 3	none	any	Details

Total release size: 3.6 MB

Release files / django_cfg-2.3.1.tar.gz

Download URL	django_cfg-2.3.1.tar.gz
Size	1.5 MB
Tags	Source
SHA-256 checksum How to use checksums	`45f0605360ae09c1c235c19a2adc0e3ba61d3dbaff208e58dfb1b9cd585f6f6f`
BLAKE2b-256 checksum How to use checksums	`04f1213f87e8edb7cb128b667f43374b01d31b105c87dd97ad5fe3c62c9a7fe5`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.8`

Release files / django_cfg-2.3.1-py3-none-any.whl

Download URL	django_cfg-2.3.1-py3-none-any.whl
Size	2.1 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`c8987998ad07b3d305a37fae8a0a1a2b5ae13e4d0a368be33e05f4f9982559eb`
BLAKE2b-256 checksum How to use checksums	`6e6c0e716b1edcddf939bc0fc8a8921da20e608d1d32cdec5b6de1e1ad82ff68`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.8`