Django-CFG

Django-CFG

PyPI Python Django License Downloads

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

Community

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

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.2.127)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for markolofsen from gravatar.com markolofsen

Credits

Author/Maintainer: Django-CFG Team

License

MIT License (MIT)

Requires

Python <3.14, >=3.12

Provides Extra

ai centrifugo dev django52 docs full gen geo local payments rq tasks test

Tags

ai-agents centrifugo configuration django django-environ django-settings enterprise-django ide-autocomplete modern-django nextjs-admin pydantic pydantic-settings react-admin real-time settings startup-validation type-safe-config type-safety typescript-generation websocket

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_cfg-2.2.125.tar.gz (1.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

django_cfg-2.2.125-py3-none-any.whl (2.2 MB view details)

Uploaded Python 3

File details

Details for the file django_cfg-2.2.125.tar.gz.

File metadata

  • Download URL: django_cfg-2.2.125.tar.gz
  • Upload date:
  • Size: 1.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.18

File hashes

Hashes for django_cfg-2.2.125.tar.gz
Algorithm Hash digest
SHA256 b0aa9df30e10e193dec1bbdaafb117649d0825ed4a529451c1761e1b19069790
MD5 2d6ade63d245294253a8f89b5a8af1ae
BLAKE2b-256 6ad2b39f8f563cebbc2cf53fed3c19a10d8b156f3abc661516177c0ea1b8d818

See more details on using hashes here.

File details

Details for the file django_cfg-2.2.125-py3-none-any.whl.

File metadata

  • Download URL: django_cfg-2.2.125-py3-none-any.whl
  • Upload date:
  • Size: 2.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.18

File hashes

Hashes for django_cfg-2.2.125-py3-none-any.whl
Algorithm Hash digest
SHA256 b85dd7a4a8accdb5c0aba30ffbf7399b835da18b7aa6b47a56de871659aceaa9
MD5 960825a67ded04622410a8e34bff04f5
BLAKE2b-256 8c028e5b313c6179223c0f0c2678ec0152f60c4100fd33fee299279ca941c6fe

See more details on using hashes here.

Release history Release notifications | RSS feed

2.2.127

2.2.126

This release

2.2.125

2.2.124

2.2.122

2.2.121

2.2.120

2.2.119

2.2.118

2.2.116

2.2.115

2.2.114

2.2.113

2.2.112

2.2.111

2.2.110

2.2.109

2.2.108

2.2.107

2.2.106

2.2.105

2.2.104

2.2.103

2.2.102

2.2.101

2.2.100

2.2.97

2.2.96

2.2.95

2.2.94

2.2.93

2.2.92

2.2.91

2.2.89

2.2.88

2.2.87

2.2.86

2.2.85

2.2.84

2.2.83

2.2.82

2.2.80

2.2.78

2.2.76

2.2.74

2.2.72

2.2.71

2.2.70

2.2.69

2.2.68

2.2.67

2.2.66

2.2.65

2.2.64

2.2.63

2.2.62

2.2.61

2.2.60

2.2.59

2.2.57

2.2.56

2.2.55

2.2.54

2.2.53

2.2.52

2.2.51

2.2.50

2.2.49

2.2.48

2.2.47

2.2.46

2.2.45

2.2.44

2.2.43

2.2.42

2.2.41

2.2.40

2.2.39

2.2.38

2.2.37

2.2.36

2.2.35

2.2.34

2.2.33

2.2.32

2.2.31

2.2.30

2.2.29

2.2.28

2.2.27

2.2.26

2.2.25

2.2.24

2.2.23

2.2.22

2.2.21

2.2.20

2.2.19

2.2.18

2.2.17

2.2.16

2.2.15

2.2.14

2.2.13

2.2.12

2.2.11

2.2.10

2.2.9

2.2.8

2.2.7

2.2.6

2.2.5

2.2.4

2.2.3

2.2.2

2.2.1

2.2.0

2.1.8

2.1.7

2.1.6

2.1.5

2.1.4

2.1.3

2.1.2

2.1.1

2.1.0

2.0.36

2.0.35

2.0.34

2.0.33

2.0.32

2.0.31

2.0.30

2.0.29

2.0.28

2.0.27

2.0.26

2.0.25

2.0.24

2.0.23

2.0.22

2.0.21

2.0.20

2.0.19

2.0.18

2.0.17

2.0.16

2.0.15

2.0.14

2.0.13

2.0.12

2.0.11

2.0.10

2.0.9

2.0.8

2.0.7

2.0.6

2.0.5

2.0.4

2.0.3

2.0.2

2.0.1

2.0.0

1.7.87

1.7.86

1.7.85

1.7.84

1.7.83

1.7.82

1.7.81

1.7.80

1.7.78

1.7.77

1.7.76

1.7.75

1.7.74

1.7.73

1.7.72

1.7.71

1.7.70

1.7.69

1.7.66

1.7.65

1.7.64

1.7.63

1.7.61

1.7.60

1.7.59

1.7.58

1.7.57

1.7.56

1.7.55

1.7.54

1.7.53

1.7.52

1.7.51

1.7.50

1.7.49

1.7.48

1.7.47

1.7.46

1.7.45

1.7.44

1.7.43

1.7.42

1.7.41

1.7.40

1.7.39

1.7.38

1.7.37

1.7.36

1.7.35

1.7.34

1.7.33

1.7.32

1.7.31

1.7.30

1.7.29

1.7.28

1.7.27

1.7.26

1.7.25

1.7.24

1.7.23

1.7.21

1.7.20

1.7.19

1.7.18

1.7.17

1.7.16

1.7.15

1.7.13

1.7.12

1.7.11

1.7.10

1.7.9

1.7.8

1.7.7

1.7.6

1.7.5

1.7.4

1.7.3

1.7.2

1.7.1

1.7.0

1.6.5

1.6.4

1.6.3

1.6.2

1.6.1

1.6.0

1.5.231

1.5.230

1.5.229

1.5.228

1.5.226

1.5.225

1.5.223

1.5.221

1.5.218

1.5.217

1.5.216

1.5.215

1.5.214

1.5.213

1.5.212

1.5.211

1.5.210

1.5.208

1.5.207

1.5.206

1.5.205

1.5.204

1.5.202

1.5.201

1.5.200

1.5.199

1.5.198

1.5.197

1.5.196

1.5.195

1.5.194

1.5.192

1.5.191

1.5.190

1.5.189

1.5.188

1.5.187

1.5.186

1.5.185

1.5.184

1.5.183

1.5.182

1.5.181

1.5.180

1.5.179

1.5.178

1.5.177

1.5.176

1.5.175

1.5.174

1.5.173

1.5.172

1.5.171

1.5.170

1.5.169

1.5.168

1.5.167

1.5.166

1.5.165

1.5.164

1.5.163

1.5.162

1.5.161

1.5.160

1.5.159

1.5.158

1.5.157

1.5.156

1.5.155

1.5.154

1.5.153

1.5.152

1.5.151

1.5.150

1.5.149

1.5.148

1.5.147

1.5.146

1.5.145

1.5.144

1.5.143

1.5.142

1.5.141

1.5.140

1.5.139

1.5.138

1.5.137

1.5.136

1.5.135

1.5.134

1.5.133

1.5.132

1.5.131

1.5.130

1.5.129

1.5.128

1.5.127

1.5.126

1.5.125

1.5.124

1.5.123

1.5.122

1.5.121

1.5.120

1.5.119

1.5.118

1.5.117

1.5.116

1.5.115

1.5.114

1.5.113

1.5.112

1.5.111

1.5.110

1.5.109

1.5.108

1.5.107

1.5.106

1.5.105

1.5.104

1.5.103

1.5.101

1.5.100

1.5.99

1.5.98

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page