Skip to main content

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 Logo

Django-CFG

PyPI Python Django License Downloads

The Modern Django Framework for Enterprise Applications

Type-safe configuration • Streamlit Admin • Real-time WebSockets • gRPC Streaming • AI-Native Docs • 8 Production Apps

Get StartedLive DemoDocumentationMCP 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
  • Streamlit Admin - Python-only admin panel, auto-starts with Django
  • 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/
  • 📊 Streamlit Dashboard → Auto-starts on port 8501
  • 📡 Real-time WebSockets → Live updates
  • 🐳 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 autocompleteStartup validationZero runtime errors


Features

🔒 Type-Safe Configuration

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

📊 Streamlit Admin

Python-only admin panel that auto-starts with Django. No npm, no Node.js - just Python.

from django_cfg import DjangoConfig
from django_cfg.modules.streamlit_admin import StreamlitAdminConfig

config = DjangoConfig(
    streamlit_admin=StreamlitAdminConfig(
        app_path="streamlit",
        auto_start=True,  # Starts with Django, dies with Django
    ),
)

📡 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

→ 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
  • AI agent framework
  • REST API with auto TypeScript generation

Admin:

  • Streamlit admin (Python-only)
  • Django Unfold for CRUD
  • JWT authentication
  • Dark theme by default

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, Streamlit admin, gRPC streaming, real-time WebSockets, and 8 production-ready apps.

Made with ❤️ for the Django community

Get StartedLive DemoGitHub

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

django_cfg-1.7.25.tar.gz (26.2 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-1.7.25-py3-none-any.whl (27.2 MB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for django_cfg-1.7.25.tar.gz
Algorithm Hash digest
SHA256 7d943e5bfadcec98b27896c5c7bc21f45ab7b97560f630494028c0a250977bd5
MD5 cd05d183b2dc6f2a961d962c64034aef
BLAKE2b-256 dfa2c3e723ce7a62d09b14c3c1b5905258a37c80b6bcabf0214ea1a2ee9392a0

See more details on using hashes here.

File details

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

File metadata

  • Download URL: django_cfg-1.7.25-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.10.18

File hashes

Hashes for django_cfg-1.7.25-py3-none-any.whl
Algorithm Hash digest
SHA256 c7ec1583a3fbc7b9e5e7be9197ea4305a724c7cdfd27d05a84b763caf0e15134
MD5 f307abdb9864db9d910101f768169b42
BLAKE2b-256 1ae866e1203a8e8f9cb7f4aa255eb7857d00d665ce8878e131844dcd556a097a

See more details on using hashes here.

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