# Django-CFG: Type-Safe Django Configuration Framework with AI-Ready Infrastructure
[](https://www.python.org/downloads/)
[](https://www.djangoproject.com/)
[](https://pypi.org/project/django-cfg/)
[](https://opensource.org/licenses/MIT)
[](https://pypi.org/project/django-cfg/)
[](https://github.com/markolofsen/django-cfg)
<div align="center">
<img src="https://raw.githubusercontent.com/markolofsen/django-cfg/refs/heads/main/static/django-cfg.png" alt="Django-CFG Framework" width="100%">
</div>
---
<div align="center">
### 🚀 Pydantic Django Settings: Reduce Django Configuration Code by 90%
**Type-safe Django configuration with Pydantic v2 models** • **Full IDE autocomplete** • **Startup validation** • **8 enterprise apps**
**[🤖 AI Project Generator](https://editor.djangocfg.com)** • **[🎯 Live Demo](http://demo.djangocfg.com)** • **[📚 Documentation](https://djangocfg.com/docs/getting-started/intro)**
</div>
## 🤖 AI Project Generator - Zero Setup Required
**Describe your app in plain English, get production-ready Django project in 30 seconds:**
> *"I need a SaaS app with user authentication, Stripe payments, and admin dashboard"*
**AI generates:** ✅ Type-safe config • ✅ Database models • ✅ REST API + docs • ✅ Modern UI • ✅ Deployment ready
### **[→ Try AI Editor Now](https://editor.djangocfg.com)**
---
## 🎯 Type-Safe Django Configuration with Pydantic v2
**Django-CFG replaces error-prone `settings.py` with type-safe Pydantic models** - eliminate runtime configuration errors, get full IDE autocomplete, and validate settings at startup. The only Django configuration framework with built-in AI agents and enterprise apps.
### Why Type-Safe Configuration Matters
**Traditional Django settings.py problems:**
- ❌ **Runtime errors** - typos caught in production, not at startup
- ❌ **No IDE support** - zero autocomplete, manual docs lookup
- ❌ **200+ lines** - unmaintainable configuration sprawl
- ❌ **Manual validation** - environment variables unchecked until used
**Django-CFG Pydantic solution:**
- ✅ **Compile-time validation** - catch errors before deployment
- ✅ **Full IDE autocomplete** - IntelliSense for all settings
- ✅ **30 lines of code** - 90% boilerplate reduction
- ✅ **Startup validation** - fail fast with clear error messages
### Django Configuration Comparison
| Feature | settings.py | django-environ | pydantic-settings | **Django-CFG** |
|---------|-------------|----------------|-------------------|----------------|
| **Type Safety** | ❌ Runtime only | ⚠️ Basic casting | ✅ Pydantic | ✅ **Full Pydantic v2** |
| **IDE Autocomplete** | ❌ None | ❌ None | ⚠️ Partial | ✅ **100%** |
| **Startup Validation** | ❌ No | ⚠️ Partial | ✅ Yes | ✅ **Yes + Custom validators** |
| **Django Integration** | ✅ Native | ⚠️ Partial | ❌ Manual | ✅ **Seamless** |
| **Built-in Apps** | ❌ Build yourself | ❌ None | ❌ None | ✅ **8 enterprise apps** |
| **AI-Ready** | ❌ Manual setup | ❌ None | ❌ None | ✅ **LLM + Vector DB** |
**[📚 Full comparison guide →](https://djangocfg.com/docs/getting-started/django-cfg-vs-alternatives)**
---
## 🚀 Three Ways to Start
### Option 1: AI Editor (Fastest - 30 seconds) ⚡
**Generate project with AI - no installation needed:**
1. Go to **[editor.djangocfg.com](https://editor.djangocfg.com)**
2. Describe your app in plain English
3. Download ready-to-deploy project
**[→ Generate with AI](https://editor.djangocfg.com)**
---
### Option 2: Traditional CLI
```bash
pip install django-cfg
django-cfg create-project "My SaaS App"
cd my-saas-app && python manage.py runserver
```
**What you get instantly:**
- 🎨 Modern Admin UI → `http://127.0.0.1:8000/admin/`
- 📚 API Docs → `http://127.0.0.1:8000/api/docs/`
- 🚀 Production-ready app
<div align="center">
<img src="https://raw.githubusercontent.com/markolofsen/django-cfg/refs/heads/main/static/startup.png" alt="Django-CFG Startup Screen" width="800">
<p><em>Django-CFG startup screen showing type-safe configuration validation</em></p>
</div>
**[📚 Installation Guide →](https://djangocfg.com/docs/getting-started/installation)**
---
### Option 3: Explore Live Demo First 🎯
**See a real production Django-CFG app in action:**
### **[→ http://demo.djangocfg.com](http://demo.djangocfg.com)**
**Demo credentials:**
- **Admin:** `demo@djangocfg.com` / `demo2024`
- **User:** `user@djangocfg.com` / `user2024`
**What you'll see:** Modern admin • Auto-generated API docs • AI agents • Support system • Payments
---
## 💡 Core Features
### 🔒 Type-Safe Django Settings with Pydantic v2 Models
**Replace Django's settings.py with Pydantic v2 for complete type safety, IDE autocomplete, and startup validation.**
#### Before: Django settings.py (Runtime Errors)
```python
# settings.py - No type checking, runtime errors
import os
DEBUG = os.getenv('DEBUG', 'False') == 'True' # ❌ String comparison bug
DATABASE_PORT = os.getenv('DB_PORT', '5432') # ❌ Still a string!
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql',
'NAME': os.getenv('DB_NAME'), # ❌ No validation until connection
'PORT': DATABASE_PORT, # ❌ Type mismatch in production
}
}
# ... 200+ more lines of unvalidated configuration
```
#### After: Django-CFG (Type-Safe Pydantic Configuration)
```python
# config.py - Type-safe Pydantic Django settings
from django_cfg import DjangoConfig
from django_cfg.models import DatabaseConfig
class MyConfig(DjangoConfig):
"""Production-grade type-safe Django configuration"""
project_name: str = "My SaaS App"
debug: bool = False # ✅ Pydantic validates boolean conversion
# Type-safe database configuration with startup validation
databases: dict[str, DatabaseConfig] = {
"default": DatabaseConfig(
name="${DB_NAME}", # ✅ Validated at startup
port=5432, # ✅ Type-checked integer
)
}
```
**Django Configuration Benefits:**
- ✅ **Pydantic v2 validation** - catch config errors before deployment
- ✅ **Full IDE autocomplete** - IntelliSense for all Django settings
- ✅ **90% less code** - reduce 200+ lines to 30 lines
- ✅ **Type hints everywhere** - mypy and pyright compatible
**[📚 Type-safe configuration guide →](https://djangocfg.com/docs/getting-started/configuration)**
---
### 🤖 AI Django Framework - Production-Ready AI Agents
**Django AI integration made simple** - type-safe AI agents, LLM workflow automation, and vector database built into Django.
```python
from django_cfg import DjangoConfig
class MyConfig(DjangoConfig):
# AI-powered Django development - zero setup
openai_api_key: str = "${OPENAI_API_KEY}"
anthropic_api_key: str = "${ANTHROPIC_API_KEY}"
# Enable AI Django agents (optional)
enable_agents: bool = True # AI workflow automation
enable_knowbase: bool = True # Vector database + RAG
```
**Django AI Features:**
- 🤖 **AI Agents Framework** - Type-safe Django LLM integration
- 📚 **Vector Database** - ChromaDB semantic search for Django
- 🔍 **RAG Integration** - Retrieval-augmented generation built-in
- 🎯 **Pydantic AI** - Type-safe AI input/output validation
- 🌐 **Multi-LLM** - OpenAI, Anthropic, Claude API support
**[📚 Django AI agents guide →](https://djangocfg.com/docs/ai-agents/introduction)**
---
### 📦 8 Production-Ready Enterprise Apps
**Ship features in days, not months** - everything you need is included:
- **👤 Accounts** - User management + OTP + SMS auth
- **🎫 Support** - Ticketing system + SLA tracking
- **📧 Newsletter** - Email campaigns + analytics
- **📊 Leads** - CRM + sales pipeline
- **🤖 AI Agents** - Optional workflow automation
- **📚 KnowBase** - Optional AI knowledge base + RAG
- **💳 Payments** - Multi-provider crypto/fiat payments
- **🔧 Maintenance** - Multi-site Cloudflare management
**Total time saved: 18 months of development**
**[📚 Explore all apps →](https://djangocfg.com/docs/features/built-in-apps)**
---
### 🎨 Modern API UI with Tailwind 4
**Beautiful browsable API** - 88% smaller bundle, 66% faster than old DRF UI.
- ✅ Glass morphism design
- ✅ Light/Dark/Auto themes
- ✅ Command palette (⌘K)
- ✅ 88% smaller bundle (278KB → 33KB)
**[📚 See API Theme →](https://djangocfg.com/docs/features/api-generation)**
---
### 🔄 Smart Multi-Database Routing
**Zero-config database routing** with automatic sharding:
```python
databases: dict[str, DatabaseConfig] = {
"analytics": DatabaseConfig(
name="${ANALYTICS_DB}",
routing_apps=["analytics", "reports"], # Auto-route!
),
}
```
✅ Auto-routes read/write • ✅ Cross-DB transactions • ✅ Connection pooling
**[📚 Multi-DB Guide →](https://djangocfg.com/docs/fundamentals/database)**
---
## ⚙️ Complete Configuration Example
**All available apps and integrations in one DjangoConfig:**
```python
from django_cfg import DjangoConfig
from django_cfg.models import DatabaseConfig, CacheConfig
class ProductionConfig(DjangoConfig):
# Project settings
project_name: str = "My Enterprise App"
secret_key: str = "${SECRET_KEY}"
debug: bool = False
# 8 Built-in Enterprise Apps (enable as needed)
enable_accounts: bool = True # 👤 User management + OTP + SMS
enable_support: bool = True # 🎫 Ticketing + SLA tracking
enable_newsletter: bool = True # 📧 Email campaigns
enable_leads: bool = True # 📊 CRM + sales pipeline
enable_agents: bool = True # 🤖 AI workflow automation
enable_knowbase: bool = True # 📚 AI knowledge base + RAG
enable_payments: bool = True # 💳 Crypto/fiat payments
enable_maintenance: bool = True # 🔧 Cloudflare management
# Infrastructure
databases: dict[str, DatabaseConfig] = {
"default": DatabaseConfig(name="${DB_NAME}"),
}
caches: dict[str, CacheConfig] = {
"default": CacheConfig(backend="redis"),
}
# AI Providers (optional)
openai_api_key: str = "${OPENAI_API_KEY}"
anthropic_api_key: str = "${ANTHROPIC_API_KEY}"
# Third-party Integrations
twilio_account_sid: str = "${TWILIO_ACCOUNT_SID}" # SMS
stripe_api_key: str = "${STRIPE_API_KEY}" # Payments
cloudflare_api_token: str = "${CF_API_TOKEN}" # CDN/DNS
```
**[📚 Full configuration reference →](https://djangocfg.com/docs/getting-started/configuration)**
---
## 📊 Django Configuration Framework Comparison
**Django-CFG vs Traditional Django, DRF, FastAPI, and django-environ:**
| Feature | Django settings.py | django-environ | DRF | FastAPI | **Django-CFG** |
|---------|-------------------|----------------|-----|---------|----------------|
| **Type-Safe Config** | ❌ Runtime | ⚠️ Basic | ❌ Manual | ✅ Pydantic | ✅ **Full Pydantic v2** |
| **IDE Autocomplete** | ❌ None | ❌ None | ❌ Manual | ⚠️ Partial | ✅ **100% IntelliSense** |
| **Startup Validation** | ❌ No | ⚠️ Partial | ❌ No | ✅ Yes | ✅ **Pydantic + Custom** |
| **Django Integration** | ✅ Native | ✅ Native | ✅ Native | ❌ Manual | ✅ **Seamless** |
| **Admin UI** | 🟡 Basic | 🟡 Basic | 🟡 Basic | ❌ None | ✅ **Modern Unfold** |
| **API Docs** | ❌ Manual | ❌ Manual | 🟡 Basic | ✅ Auto | ✅ **OpenAPI + Swagger** |
| **AI Agents Built-in** | ❌ Manual | ❌ None | ❌ Manual | ❌ Manual | ✅ **LLM Framework** |
| **Setup Time** | 🟡 Weeks | 🟡 Hours | 🟡 Weeks | 🟡 Days | ✅ **30 seconds** |
| **Enterprise Apps** | ❌ Build all | ❌ None | ❌ Build all | ❌ Build all | ✅ **8 included** |
| **Configuration Lines** | ⚠️ 200+ | ⚠️ 150+ | ⚠️ 200+ | ⚠️ 100+ | ✅ **30 lines** |
**Legend:** ✅ Excellent | 🟡 Requires Work | ⚠️ Partial | ❌ Not Available
**[📚 Django-CFG vs django-environ detailed comparison →](https://djangocfg.com/docs/getting-started/django-cfg-vs-alternatives)**
---
## 📚 Documentation
### 🚀 Getting Started
- **[Installation](https://djangocfg.com/docs/getting-started/installation)** - Quick setup guide
- **[First Project](https://djangocfg.com/docs/getting-started/first-project)** - Create your first app
- **[Configuration](https://djangocfg.com/docs/getting-started/configuration)** - Type-safe config guide
- **[Why Django-CFG?](https://djangocfg.com/docs/getting-started/why-django-cfg)** - Full comparison
### 🏗️ Core Features
- **[Built-in Apps](https://djangocfg.com/docs/features/built-in-apps)** - 8 enterprise apps
- **[API Generation](https://djangocfg.com/docs/features/api-generation)** - Auto OpenAPI docs
- **[Database](https://djangocfg.com/docs/fundamentals/database)** - Multi-DB routing
- **[Integrations](https://djangocfg.com/docs/features/integrations)** - Third-party services
### 🤖 AI Integration (Optional)
- **[AI Agents](https://djangocfg.com/docs/ai-agents/introduction)** - Workflow automation
- **[Creating Agents](https://djangocfg.com/docs/ai-agents/creating-agents)** - Build custom agents
- **[Django Integration](https://djangocfg.com/docs/ai-agents/django-integration)** - Connect to your app
### 🚀 Deployment
- **[Production Config](https://djangocfg.com/docs/deployment)** - Production best practices
- **[CLI Commands](https://djangocfg.com/docs/cli)** - 50+ management commands
---
## 🤝 Community & Support
### Resources
- 🌐 **[djangocfg.com](https://djangocfg.com/)** - Official website & documentation
- 🐙 **[GitHub](https://github.com/markolofsen/django-cfg)** - Source code & issues
- 💬 **[Discussions](https://github.com/markolofsen/django-cfg/discussions)** - Community support
### Links
- **[🚀 AI Project Generator](https://editor.djangocfg.com)** - Generate projects with AI
- **[🎯 Live Demo](http://demo.djangocfg.com)** - See it in action
- **[📦 PyPI](https://pypi.org/project/django-cfg/)** - Package repository
---
## 📄 License
**MIT License** - Free for commercial use
---
**Made with ❤️ by the Django-CFG Team**
---
<div align="center">
**Django AI Framework** • **Type-Safe Configuration** • **Pydantic Settings** • **Enterprise Apps**
Django-CFG is the AI-first Django framework for production-ready AI agents, type-safe Pydantic v2 configuration, and enterprise development. Replace settings.py with validated models, build AI workflows with Django ORM integration, and ship faster with 8 built-in apps. Perfect for Django LLM integration, AI-powered Django development, scalable Django architecture, and reducing Django boilerplate.
---
**Get Started:** **[Documentation](https://djangocfg.com/docs/getting-started/intro)** • **[AI Project Generator](https://editor.djangocfg.com)** • **[Live Demo](http://demo.djangocfg.com)**
</div>
Raw data
{
"_id": null,
"home_page": null,
"name": "django-cfg",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.14,>=3.12",
"maintainer_email": "Django-CFG Team <info@djangocfg.com>",
"keywords": "ai-agents, configuration, django, django-environ, django-settings, enterprise-django, ide-autocomplete, pydantic, pydantic-settings, settings, startup-validation, type-safe-config, type-safety",
"author": null,
"author_email": "Django-CFG Team <info@djangocfg.com>",
"download_url": "https://files.pythonhosted.org/packages/ea/c2/9ecfa16a5d421deff99274d4e71b000b01202abfba1986c0eead160f71c0/django_cfg-1.4.81.tar.gz",
"platform": null,
"description": "# Django-CFG: Type-Safe Django Configuration Framework with AI-Ready Infrastructure\n\n[](https://www.python.org/downloads/)\n[](https://www.djangoproject.com/)\n[](https://pypi.org/project/django-cfg/)\n[](https://opensource.org/licenses/MIT)\n[](https://pypi.org/project/django-cfg/)\n[](https://github.com/markolofsen/django-cfg)\n\n<div align=\"center\">\n<img src=\"https://raw.githubusercontent.com/markolofsen/django-cfg/refs/heads/main/static/django-cfg.png\" alt=\"Django-CFG Framework\" width=\"100%\">\n</div>\n\n---\n\n<div align=\"center\">\n\n### \ud83d\ude80 Pydantic Django Settings: Reduce Django Configuration Code by 90%\n\n**Type-safe Django configuration with Pydantic v2 models** \u2022 **Full IDE autocomplete** \u2022 **Startup validation** \u2022 **8 enterprise apps**\n\n**[\ud83e\udd16 AI Project Generator](https://editor.djangocfg.com)** \u2022 **[\ud83c\udfaf Live Demo](http://demo.djangocfg.com)** \u2022 **[\ud83d\udcda Documentation](https://djangocfg.com/docs/getting-started/intro)**\n\n</div>\n\n## \ud83e\udd16 AI Project Generator - Zero Setup Required\n\n**Describe your app in plain English, get production-ready Django project in 30 seconds:**\n\n> *\"I need a SaaS app with user authentication, Stripe payments, and admin dashboard\"*\n\n**AI generates:** \u2705 Type-safe config \u2022 \u2705 Database models \u2022 \u2705 REST API + docs \u2022 \u2705 Modern UI \u2022 \u2705 Deployment ready\n\n### **[\u2192 Try AI Editor Now](https://editor.djangocfg.com)**\n\n---\n\n## \ud83c\udfaf Type-Safe Django Configuration with Pydantic v2\n\n**Django-CFG replaces error-prone `settings.py` with type-safe Pydantic models** - eliminate runtime configuration errors, get full IDE autocomplete, and validate settings at startup. The only Django configuration framework with built-in AI agents and enterprise apps.\n\n### Why Type-Safe Configuration Matters\n\n**Traditional Django settings.py problems:**\n- \u274c **Runtime errors** - typos caught in production, not at startup\n- \u274c **No IDE support** - zero autocomplete, manual docs lookup\n- \u274c **200+ lines** - unmaintainable configuration sprawl\n- \u274c **Manual validation** - environment variables unchecked until used\n\n**Django-CFG Pydantic solution:**\n- \u2705 **Compile-time validation** - catch errors before deployment\n- \u2705 **Full IDE autocomplete** - IntelliSense for all settings\n- \u2705 **30 lines of code** - 90% boilerplate reduction\n- \u2705 **Startup validation** - fail fast with clear error messages\n\n### Django Configuration Comparison\n\n| Feature | settings.py | django-environ | pydantic-settings | **Django-CFG** |\n|---------|-------------|----------------|-------------------|----------------|\n| **Type Safety** | \u274c Runtime only | \u26a0\ufe0f Basic casting | \u2705 Pydantic | \u2705 **Full Pydantic v2** |\n| **IDE Autocomplete** | \u274c None | \u274c None | \u26a0\ufe0f Partial | \u2705 **100%** |\n| **Startup Validation** | \u274c No | \u26a0\ufe0f Partial | \u2705 Yes | \u2705 **Yes + Custom validators** |\n| **Django Integration** | \u2705 Native | \u26a0\ufe0f Partial | \u274c Manual | \u2705 **Seamless** |\n| **Built-in Apps** | \u274c Build yourself | \u274c None | \u274c None | \u2705 **8 enterprise apps** |\n| **AI-Ready** | \u274c Manual setup | \u274c None | \u274c None | \u2705 **LLM + Vector DB** |\n\n**[\ud83d\udcda Full comparison guide \u2192](https://djangocfg.com/docs/getting-started/django-cfg-vs-alternatives)**\n\n---\n\n## \ud83d\ude80 Three Ways to Start\n\n### Option 1: AI Editor (Fastest - 30 seconds) \u26a1\n\n**Generate project with AI - no installation needed:**\n\n1. Go to **[editor.djangocfg.com](https://editor.djangocfg.com)**\n2. Describe your app in plain English\n3. Download ready-to-deploy project\n\n**[\u2192 Generate with AI](https://editor.djangocfg.com)**\n\n---\n\n### Option 2: Traditional CLI\n\n```bash\npip install django-cfg\ndjango-cfg create-project \"My SaaS App\"\ncd my-saas-app && python manage.py runserver\n```\n\n**What you get instantly:**\n- \ud83c\udfa8 Modern Admin UI \u2192 `http://127.0.0.1:8000/admin/`\n- \ud83d\udcda API Docs \u2192 `http://127.0.0.1:8000/api/docs/`\n- \ud83d\ude80 Production-ready app\n\n<div align=\"center\">\n<img src=\"https://raw.githubusercontent.com/markolofsen/django-cfg/refs/heads/main/static/startup.png\" alt=\"Django-CFG Startup Screen\" width=\"800\">\n<p><em>Django-CFG startup screen showing type-safe configuration validation</em></p>\n</div>\n\n**[\ud83d\udcda Installation Guide \u2192](https://djangocfg.com/docs/getting-started/installation)**\n\n---\n\n### Option 3: Explore Live Demo First \ud83c\udfaf\n\n**See a real production Django-CFG app in action:**\n\n### **[\u2192 http://demo.djangocfg.com](http://demo.djangocfg.com)**\n\n**Demo credentials:**\n- **Admin:** `demo@djangocfg.com` / `demo2024`\n- **User:** `user@djangocfg.com` / `user2024`\n\n**What you'll see:** Modern admin \u2022 Auto-generated API docs \u2022 AI agents \u2022 Support system \u2022 Payments\n\n---\n\n## \ud83d\udca1 Core Features\n\n### \ud83d\udd12 Type-Safe Django Settings with Pydantic v2 Models\n\n**Replace Django's settings.py with Pydantic v2 for complete type safety, IDE autocomplete, and startup validation.**\n\n#### Before: Django settings.py (Runtime Errors)\n\n```python\n# settings.py - No type checking, runtime errors\nimport os\n\nDEBUG = os.getenv('DEBUG', 'False') == 'True' # \u274c String comparison bug\nDATABASE_PORT = os.getenv('DB_PORT', '5432') # \u274c Still a string!\n\nDATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.postgresql',\n 'NAME': os.getenv('DB_NAME'), # \u274c No validation until connection\n 'PORT': DATABASE_PORT, # \u274c Type mismatch in production\n }\n}\n# ... 200+ more lines of unvalidated configuration\n```\n\n#### After: Django-CFG (Type-Safe Pydantic Configuration)\n\n```python\n# config.py - Type-safe Pydantic Django settings\nfrom django_cfg import DjangoConfig\nfrom django_cfg.models import DatabaseConfig\n\nclass MyConfig(DjangoConfig):\n \"\"\"Production-grade type-safe Django configuration\"\"\"\n\n project_name: str = \"My SaaS App\"\n debug: bool = False # \u2705 Pydantic validates boolean conversion\n\n # Type-safe database configuration with startup validation\n databases: dict[str, DatabaseConfig] = {\n \"default\": DatabaseConfig(\n name=\"${DB_NAME}\", # \u2705 Validated at startup\n port=5432, # \u2705 Type-checked integer\n )\n }\n```\n\n**Django Configuration Benefits:**\n- \u2705 **Pydantic v2 validation** - catch config errors before deployment\n- \u2705 **Full IDE autocomplete** - IntelliSense for all Django settings\n- \u2705 **90% less code** - reduce 200+ lines to 30 lines\n- \u2705 **Type hints everywhere** - mypy and pyright compatible\n\n**[\ud83d\udcda Type-safe configuration guide \u2192](https://djangocfg.com/docs/getting-started/configuration)**\n\n---\n\n### \ud83e\udd16 AI Django Framework - Production-Ready AI Agents\n\n**Django AI integration made simple** - type-safe AI agents, LLM workflow automation, and vector database built into Django.\n\n```python\nfrom django_cfg import DjangoConfig\n\nclass MyConfig(DjangoConfig):\n # AI-powered Django development - zero setup\n openai_api_key: str = \"${OPENAI_API_KEY}\"\n anthropic_api_key: str = \"${ANTHROPIC_API_KEY}\"\n\n # Enable AI Django agents (optional)\n enable_agents: bool = True # AI workflow automation\n enable_knowbase: bool = True # Vector database + RAG\n```\n\n**Django AI Features:**\n- \ud83e\udd16 **AI Agents Framework** - Type-safe Django LLM integration\n- \ud83d\udcda **Vector Database** - ChromaDB semantic search for Django\n- \ud83d\udd0d **RAG Integration** - Retrieval-augmented generation built-in\n- \ud83c\udfaf **Pydantic AI** - Type-safe AI input/output validation\n- \ud83c\udf10 **Multi-LLM** - OpenAI, Anthropic, Claude API support\n\n**[\ud83d\udcda Django AI agents guide \u2192](https://djangocfg.com/docs/ai-agents/introduction)**\n\n---\n\n### \ud83d\udce6 8 Production-Ready Enterprise Apps\n\n**Ship features in days, not months** - everything you need is included:\n\n- **\ud83d\udc64 Accounts** - User management + OTP + SMS auth\n- **\ud83c\udfab Support** - Ticketing system + SLA tracking\n- **\ud83d\udce7 Newsletter** - Email campaigns + analytics\n- **\ud83d\udcca Leads** - CRM + sales pipeline\n- **\ud83e\udd16 AI Agents** - Optional workflow automation\n- **\ud83d\udcda KnowBase** - Optional AI knowledge base + RAG\n- **\ud83d\udcb3 Payments** - Multi-provider crypto/fiat payments\n- **\ud83d\udd27 Maintenance** - Multi-site Cloudflare management\n\n**Total time saved: 18 months of development**\n\n**[\ud83d\udcda Explore all apps \u2192](https://djangocfg.com/docs/features/built-in-apps)**\n\n---\n\n### \ud83c\udfa8 Modern API UI with Tailwind 4\n\n**Beautiful browsable API** - 88% smaller bundle, 66% faster than old DRF UI.\n\n- \u2705 Glass morphism design\n- \u2705 Light/Dark/Auto themes\n- \u2705 Command palette (\u2318K)\n- \u2705 88% smaller bundle (278KB \u2192 33KB)\n\n**[\ud83d\udcda See API Theme \u2192](https://djangocfg.com/docs/features/api-generation)**\n\n---\n\n### \ud83d\udd04 Smart Multi-Database Routing\n\n**Zero-config database routing** with automatic sharding:\n\n```python\ndatabases: dict[str, DatabaseConfig] = {\n \"analytics\": DatabaseConfig(\n name=\"${ANALYTICS_DB}\",\n routing_apps=[\"analytics\", \"reports\"], # Auto-route!\n ),\n}\n```\n\n\u2705 Auto-routes read/write \u2022 \u2705 Cross-DB transactions \u2022 \u2705 Connection pooling\n\n**[\ud83d\udcda Multi-DB Guide \u2192](https://djangocfg.com/docs/fundamentals/database)**\n\n---\n\n## \u2699\ufe0f Complete Configuration Example\n\n**All available apps and integrations in one DjangoConfig:**\n\n```python\nfrom django_cfg import DjangoConfig\nfrom django_cfg.models import DatabaseConfig, CacheConfig\n\nclass ProductionConfig(DjangoConfig):\n # Project settings\n project_name: str = \"My Enterprise App\"\n secret_key: str = \"${SECRET_KEY}\"\n debug: bool = False\n\n # 8 Built-in Enterprise Apps (enable as needed)\n enable_accounts: bool = True # \ud83d\udc64 User management + OTP + SMS\n enable_support: bool = True # \ud83c\udfab Ticketing + SLA tracking\n enable_newsletter: bool = True # \ud83d\udce7 Email campaigns\n enable_leads: bool = True # \ud83d\udcca CRM + sales pipeline\n enable_agents: bool = True # \ud83e\udd16 AI workflow automation\n enable_knowbase: bool = True # \ud83d\udcda AI knowledge base + RAG\n enable_payments: bool = True # \ud83d\udcb3 Crypto/fiat payments\n enable_maintenance: bool = True # \ud83d\udd27 Cloudflare management\n\n # Infrastructure\n databases: dict[str, DatabaseConfig] = {\n \"default\": DatabaseConfig(name=\"${DB_NAME}\"),\n }\n caches: dict[str, CacheConfig] = {\n \"default\": CacheConfig(backend=\"redis\"),\n }\n\n # AI Providers (optional)\n openai_api_key: str = \"${OPENAI_API_KEY}\"\n anthropic_api_key: str = \"${ANTHROPIC_API_KEY}\"\n\n # Third-party Integrations\n twilio_account_sid: str = \"${TWILIO_ACCOUNT_SID}\" # SMS\n stripe_api_key: str = \"${STRIPE_API_KEY}\" # Payments\n cloudflare_api_token: str = \"${CF_API_TOKEN}\" # CDN/DNS\n```\n\n**[\ud83d\udcda Full configuration reference \u2192](https://djangocfg.com/docs/getting-started/configuration)**\n\n---\n\n## \ud83d\udcca Django Configuration Framework Comparison\n\n**Django-CFG vs Traditional Django, DRF, FastAPI, and django-environ:**\n\n| Feature | Django settings.py | django-environ | DRF | FastAPI | **Django-CFG** |\n|---------|-------------------|----------------|-----|---------|----------------|\n| **Type-Safe Config** | \u274c Runtime | \u26a0\ufe0f Basic | \u274c Manual | \u2705 Pydantic | \u2705 **Full Pydantic v2** |\n| **IDE Autocomplete** | \u274c None | \u274c None | \u274c Manual | \u26a0\ufe0f Partial | \u2705 **100% IntelliSense** |\n| **Startup Validation** | \u274c No | \u26a0\ufe0f Partial | \u274c No | \u2705 Yes | \u2705 **Pydantic + Custom** |\n| **Django Integration** | \u2705 Native | \u2705 Native | \u2705 Native | \u274c Manual | \u2705 **Seamless** |\n| **Admin UI** | \ud83d\udfe1 Basic | \ud83d\udfe1 Basic | \ud83d\udfe1 Basic | \u274c None | \u2705 **Modern Unfold** |\n| **API Docs** | \u274c Manual | \u274c Manual | \ud83d\udfe1 Basic | \u2705 Auto | \u2705 **OpenAPI + Swagger** |\n| **AI Agents Built-in** | \u274c Manual | \u274c None | \u274c Manual | \u274c Manual | \u2705 **LLM Framework** |\n| **Setup Time** | \ud83d\udfe1 Weeks | \ud83d\udfe1 Hours | \ud83d\udfe1 Weeks | \ud83d\udfe1 Days | \u2705 **30 seconds** |\n| **Enterprise Apps** | \u274c Build all | \u274c None | \u274c Build all | \u274c Build all | \u2705 **8 included** |\n| **Configuration Lines** | \u26a0\ufe0f 200+ | \u26a0\ufe0f 150+ | \u26a0\ufe0f 200+ | \u26a0\ufe0f 100+ | \u2705 **30 lines** |\n\n**Legend:** \u2705 Excellent | \ud83d\udfe1 Requires Work | \u26a0\ufe0f Partial | \u274c Not Available\n\n**[\ud83d\udcda Django-CFG vs django-environ detailed comparison \u2192](https://djangocfg.com/docs/getting-started/django-cfg-vs-alternatives)**\n\n---\n\n## \ud83d\udcda Documentation\n\n### \ud83d\ude80 Getting Started\n- **[Installation](https://djangocfg.com/docs/getting-started/installation)** - Quick setup guide\n- **[First Project](https://djangocfg.com/docs/getting-started/first-project)** - Create your first app\n- **[Configuration](https://djangocfg.com/docs/getting-started/configuration)** - Type-safe config guide\n- **[Why Django-CFG?](https://djangocfg.com/docs/getting-started/why-django-cfg)** - Full comparison\n\n### \ud83c\udfd7\ufe0f Core Features\n- **[Built-in Apps](https://djangocfg.com/docs/features/built-in-apps)** - 8 enterprise apps\n- **[API Generation](https://djangocfg.com/docs/features/api-generation)** - Auto OpenAPI docs\n- **[Database](https://djangocfg.com/docs/fundamentals/database)** - Multi-DB routing\n- **[Integrations](https://djangocfg.com/docs/features/integrations)** - Third-party services\n\n### \ud83e\udd16 AI Integration (Optional)\n- **[AI Agents](https://djangocfg.com/docs/ai-agents/introduction)** - Workflow automation\n- **[Creating Agents](https://djangocfg.com/docs/ai-agents/creating-agents)** - Build custom agents\n- **[Django Integration](https://djangocfg.com/docs/ai-agents/django-integration)** - Connect to your app\n\n### \ud83d\ude80 Deployment\n- **[Production Config](https://djangocfg.com/docs/deployment)** - Production best practices\n- **[CLI Commands](https://djangocfg.com/docs/cli)** - 50+ management commands\n\n---\n\n## \ud83e\udd1d Community & Support\n\n### Resources\n- \ud83c\udf10 **[djangocfg.com](https://djangocfg.com/)** - Official website & documentation\n- \ud83d\udc19 **[GitHub](https://github.com/markolofsen/django-cfg)** - Source code & issues\n- \ud83d\udcac **[Discussions](https://github.com/markolofsen/django-cfg/discussions)** - Community support\n\n### Links\n- **[\ud83d\ude80 AI Project Generator](https://editor.djangocfg.com)** - Generate projects with AI\n- **[\ud83c\udfaf Live Demo](http://demo.djangocfg.com)** - See it in action\n- **[\ud83d\udce6 PyPI](https://pypi.org/project/django-cfg/)** - Package repository\n\n---\n\n## \ud83d\udcc4 License\n\n**MIT License** - Free for commercial use\n\n---\n\n**Made with \u2764\ufe0f by the Django-CFG Team**\n\n---\n\n<div align=\"center\">\n\n**Django AI Framework** \u2022 **Type-Safe Configuration** \u2022 **Pydantic Settings** \u2022 **Enterprise Apps**\n\nDjango-CFG is the AI-first Django framework for production-ready AI agents, type-safe Pydantic v2 configuration, and enterprise development. Replace settings.py with validated models, build AI workflows with Django ORM integration, and ship faster with 8 built-in apps. Perfect for Django LLM integration, AI-powered Django development, scalable Django architecture, and reducing Django boilerplate.\n\n---\n\n**Get Started:** **[Documentation](https://djangocfg.com/docs/getting-started/intro)** \u2022 **[AI Project Generator](https://editor.djangocfg.com)** \u2022 **[Live Demo](http://demo.djangocfg.com)**\n\n</div>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Django AI framework with built-in agents, type-safe Pydantic v2 configuration, and 8 enterprise apps. Replace settings.py, validate at startup, 90% less code. Production-ready AI workflows for Django.",
"version": "1.4.81",
"project_urls": {
"Changelog": "https://github.com/markolofsen/django-cfg/blob/main/CHANGELOG.md",
"Documentation": "https://djangocfg.com",
"Homepage": "https://djangocfg.com",
"Issues": "https://github.com/markolofsen/django-cfg/issues",
"Repository": "https://github.com/markolofsen/django-cfg"
},
"split_keywords": [
"ai-agents",
" configuration",
" django",
" django-environ",
" django-settings",
" enterprise-django",
" ide-autocomplete",
" pydantic",
" pydantic-settings",
" settings",
" startup-validation",
" type-safe-config",
" type-safety"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "056bf4c0c421f6a116cd278e2313d6653d6926d4b0f1e6145650dbc0e9214e1e",
"md5": "a90a4b12c2fc7a0982dc3a604751bc71",
"sha256": "71c9d756eb66841b5a4e7d5a492338815dfd3241356b19168afd6a6aaa605e01"
},
"downloads": -1,
"filename": "django_cfg-1.4.81-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a90a4b12c2fc7a0982dc3a604751bc71",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.14,>=3.12",
"size": 1652293,
"upload_time": "2025-10-26T14:02:03",
"upload_time_iso_8601": "2025-10-26T14:02:03.527718Z",
"url": "https://files.pythonhosted.org/packages/05/6b/f4c0c421f6a116cd278e2313d6653d6926d4b0f1e6145650dbc0e9214e1e/django_cfg-1.4.81-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "eac29ecfa16a5d421deff99274d4e71b000b01202abfba1986c0eead160f71c0",
"md5": "97f4172e3e93e9363051626566547e20",
"sha256": "fdddd848958d8e0d7ec51064bffd52d25829a33051feab3b9675087b821708de"
},
"downloads": -1,
"filename": "django_cfg-1.4.81.tar.gz",
"has_sig": false,
"md5_digest": "97f4172e3e93e9363051626566547e20",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.14,>=3.12",
"size": 1091402,
"upload_time": "2025-10-26T14:02:07",
"upload_time_iso_8601": "2025-10-26T14:02:07.578827Z",
"url": "https://files.pythonhosted.org/packages/ea/c2/9ecfa16a5d421deff99274d4e71b000b01202abfba1986c0eead160f71c0/django_cfg-1.4.81.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-26 14:02:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "markolofsen",
"github_project": "django-cfg",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "django-cfg"
}
JSON
