Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features.
Project description
Django-CFG
The Modern Django Framework for Enterprise Applications
Type-safe configuration • Next.js Admin • Real-time WebSockets • gRPC Streaming • AI-Native Docs • 8 Production Apps
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
- ✅ Built-in Next.js admin - Modern React admin interface out of the box
- ✅ 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
- ✅ 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 →
http://127.0.0.1:8000/admin/ - ⚛️ Next.js Dashboard → Modern React interface
- 📡 Real-time WebSockets → Live updates
- 🐳 Docker Ready → Production configs
- 🖥️ Electron App → Desktop template
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.
⚛️ Next.js Admin
Only Django framework with built-in Next.js integration - modern admin UI out of the box.
📡 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.
🤖 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
What's Included
Backend:
- Django 5.2+ with type-safe config
- PostgreSQL, Redis, Centrifugo
- gRPC server with streaming
- 8 production-ready apps
- AI agent framework
- REST API with auto TypeScript generation
Frontend:
- Next.js 16 admin interface
- React 19 + TypeScript
- Tailwind CSS 4
- Real-time WebSocket client
- PWA support
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
- Next.js Admin - Modern admin UI
- 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, Next.js admin, gRPC streaming, real-time WebSockets, and 8 production-ready apps.
Made with ❤️ for the Django community
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_cfg-1.5.213.tar.gz.
File metadata
- Download URL: django_cfg-1.5.213.tar.gz
- Upload date:
- Size: 26.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
74305a06f185bdaada9e56c12cefe63a8d865fbfc89a7e55374512f65cc0dcc5
|
|
| MD5 |
48c4fea316b49cb009f075f30b4702a2
|
|
| BLAKE2b-256 |
e620b1666198243a5b30d92ef2e08bd265b72ee0b2d86c711696c1ba087d13d2
|
File details
Details for the file django_cfg-1.5.213-py3-none-any.whl.
File metadata
- Download URL: django_cfg-1.5.213-py3-none-any.whl
- Upload date:
- Size: 27.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2af30d47c90bf5b08ce60e07353ccf624529870f3bf18ccb2d98d27076ae6057
|
|
| MD5 |
a2f22423add6931e07fa5dbebdbd1d17
|
|
| BLAKE2b-256 |
ebf31a8bdcdd9150e414b3d3956be41c421af9eafb81214f27a2271a3d001f0e
|