django-cfg 1.4.21__tar.gz → 1.4.24__tar.gz

django_cfg-1.4.24/PKG-INFO

@@ -0,0 +1,533 @@
+Metadata-Version: 2.4
+Name: django-cfg
+Version: 1.4.24
+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.
+Project-URL: Homepage, https://djangocfg.com
+Project-URL: Documentation, https://djangocfg.com
+Project-URL: Repository, https://github.com/markolofsen/django-cfg
+Project-URL: Issues, https://github.com/markolofsen/django-cfg/issues
+Project-URL: Changelog, https://github.com/markolofsen/django-cfg/blob/main/CHANGELOG.md
+Author-email: Django-CFG Team <info@djangocfg.com>
+Maintainer-email: Django-CFG Team <info@djangocfg.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai-agents,configuration,django,django-environ,django-settings,enterprise-django,ide-autocomplete,pydantic,pydantic-settings,settings,startup-validation,type-safe-config,type-safety
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5.2
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Classifier: Typing :: Typed
+Requires-Python: <4.0,>=3.12
+Requires-Dist: beautifulsoup4<5.0,>=4.13.0
+Requires-Dist: cachetools<7.0,>=5.3.0
+Requires-Dist: click<9.0,>=8.2.0
+Requires-Dist: cloudflare<5.0,>=4.3.0
+Requires-Dist: colorlog<7.0,>=6.9.0
+Requires-Dist: coolname<3.0,>=2.2.0
+Requires-Dist: dj-database-url<4.0,>=3.0.0
+Requires-Dist: django-admin-rangefilter<1.0,>=0.13.0
+Requires-Dist: django-constance<5.0,>=4.3.0
+Requires-Dist: django-cors-headers<5.0,>=4.7.0
+Requires-Dist: django-dramatiq<1.0,>=0.14.0
+Requires-Dist: django-extensions<5.0,>=4.1.0
+Requires-Dist: django-filter<26.0,>=25.0
+Requires-Dist: django-import-export<5.0,>=4.3.0
+Requires-Dist: django-json-widget<3.0,>=2.0.0
+Requires-Dist: django-ratelimit<5.0.0,>=4.1.0
+Requires-Dist: django-redis<7.0,>=6.0.0
+Requires-Dist: django-tailwind[reload]<5.0.0,>=4.2.0
+Requires-Dist: django-unfold<1.0,>=0.64.0
+Requires-Dist: djangorestframework-simplejwt<6.0,>=5.5.0
+Requires-Dist: djangorestframework-simplejwt[token-blacklist]<6.0,>=5.5.0
+Requires-Dist: djangorestframework<4.0,>=3.16.0
+Requires-Dist: dramatiq[redis]<2.0,>=1.18.0
+Requires-Dist: drf-nested-routers<1.0,>=0.94.0
+Requires-Dist: drf-spectacular-sidecar<2026.0,>=2025.8.0
+Requires-Dist: drf-spectacular<1.0,>=0.28.0
+Requires-Dist: hiredis<4.0,>=2.0.0
+Requires-Dist: jinja2<4.0.0,>=3.1.6
+Requires-Dist: loguru<1.0,>=0.7.0
+Requires-Dist: lxml<7.0,>=6.0.0
+Requires-Dist: mypy<2.0.0,>=1.18.2
+Requires-Dist: ngrok>=1.5.1; python_version >= '3.12'
+Requires-Dist: openai<2.0,>=1.107.0
+Requires-Dist: pgvector<1.0,>=0.4.0
+Requires-Dist: psycopg[binary,pool]<4.0,>=3.2.0
+Requires-Dist: pydantic-ai<2.0,>=1.0.10
+Requires-Dist: pydantic-yaml<2.0,>=1.6.0
+Requires-Dist: pydantic<3.0,>=2.11.0
+Requires-Dist: pydantic[email]<3.0,>=2.11.0
+Requires-Dist: pytelegrambotapi<5.0,>=4.28.0
+Requires-Dist: python-json-logger<4.0,>=3.3.0
+Requires-Dist: pyyaml<7.0,>=6.0
+Requires-Dist: questionary<3.0,>=2.1.0
+Requires-Dist: redis<7.0,>=6.4.0
+Requires-Dist: requests<3.0,>=2.32.0
+Requires-Dist: rich<15.0,>=14.0.0
+Requires-Dist: sendgrid<7.0,>=6.12.0
+Requires-Dist: tenacity<10.0.0,>=9.1.2
+Requires-Dist: tiktoken<1.0,>=0.11.0
+Requires-Dist: toml<0.11.0,>=0.10.2
+Requires-Dist: twilio<10.0,>=9.8.0
+Requires-Dist: whitenoise<7.0,>=6.8.0
+Provides-Extra: dev
+Requires-Dist: black<26.0,>=25.9; extra == 'dev'
+Requires-Dist: build<2.0,>=1.3; extra == 'dev'
+Requires-Dist: django<6.0,>=5.2; extra == 'dev'
+Requires-Dist: factory-boy<4.0,>=3.3; extra == 'dev'
+Requires-Dist: fakeredis<3.0,>=2.28; extra == 'dev'
+Requires-Dist: flake8<8.0,>=6.0.0; extra == 'dev'
+Requires-Dist: isort<7.0,>=6.0; extra == 'dev'
+Requires-Dist: mkdocs-material<10.0,>=9.6; extra == 'dev'
+Requires-Dist: mkdocs<2.0,>=1.6; extra == 'dev'
+Requires-Dist: mkdocstrings[python]<1.0,>=0.30; extra == 'dev'
+Requires-Dist: mypy<2.0,>=1.18; extra == 'dev'
+Requires-Dist: pre-commit<5.0,>=4.3; extra == 'dev'
+Requires-Dist: pytest-cov<8.0,>=7.0; extra == 'dev'
+Requires-Dist: pytest-django<5.0,>=4.11; extra == 'dev'
+Requires-Dist: pytest-mock<4.0,>=3.15; extra == 'dev'
+Requires-Dist: pytest<9.0,>=8.4; extra == 'dev'
+Requires-Dist: questionary<3.0,>=2.1.0; extra == 'dev'
+Requires-Dist: redis<7.0,>=6.4.0; extra == 'dev'
+Requires-Dist: rich<15.0,>=13.0.0; extra == 'dev'
+Requires-Dist: tomlkit<1.0,>=0.13.3; extra == 'dev'
+Requires-Dist: twine<7.0,>=6.2; extra == 'dev'
+Provides-Extra: django52
+Requires-Dist: django<6.0,>=5.2; extra == 'django52'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material<10.0,>=9.6; extra == 'docs'
+Requires-Dist: mkdocs<2.0,>=1.6; extra == 'docs'
+Requires-Dist: mkdocstrings[python]<1.0,>=0.30; extra == 'docs'
+Requires-Dist: pymdown-extensions<11.0,>=10.16; extra == 'docs'
+Provides-Extra: full
+Requires-Dist: black<26.0,>=25.9; extra == 'full'
+Requires-Dist: build<2.0,>=1.3; extra == 'full'
+Requires-Dist: django<6.0,>=5.2; extra == 'full'
+Requires-Dist: factory-boy<4.0,>=3.3; extra == 'full'
+Requires-Dist: flake8<8.0,>=6.0.0; extra == 'full'
+Requires-Dist: isort<7.0,>=6.0; extra == 'full'
+Requires-Dist: mkdocs-material<10.0,>=9.6; extra == 'full'
+Requires-Dist: mkdocs<2.0,>=1.6; extra == 'full'
+Requires-Dist: mkdocstrings[python]<1.0,>=0.30; extra == 'full'
+Requires-Dist: mypy<2.0,>=1.18; extra == 'full'
+Requires-Dist: pre-commit<5.0,>=4.3; extra == 'full'
+Requires-Dist: pymdown-extensions<11.0,>=10.16; extra == 'full'
+Requires-Dist: pytest-cov<8.0,>=7.0; extra == 'full'
+Requires-Dist: pytest-django<5.0,>=4.11; extra == 'full'
+Requires-Dist: pytest-mock<4.0,>=3.15; extra == 'full'
+Requires-Dist: pytest-xdist<4.0,>=3.8; extra == 'full'
+Requires-Dist: pytest<9.0,>=8.4; extra == 'full'
+Requires-Dist: questionary<3.0,>=2.1.0; extra == 'full'
+Requires-Dist: redis<7.0,>=6.4.0; extra == 'full'
+Requires-Dist: rich<15.0,>=13.0.0; extra == 'full'
+Requires-Dist: tomlkit<1.0,>=0.13.3; extra == 'full'
+Requires-Dist: twine<7.0,>=6.2; extra == 'full'
+Provides-Extra: local
+Provides-Extra: tasks
+Requires-Dist: redis<7.0,>=6.4.0; extra == 'tasks'
+Provides-Extra: test
+Requires-Dist: django<6.0,>=5.2; extra == 'test'
+Requires-Dist: factory-boy<4.0,>=3.3; extra == 'test'
+Requires-Dist: fakeredis<3.0,>=2.28; extra == 'test'
+Requires-Dist: pytest-cov<8.0,>=7.0; extra == 'test'
+Requires-Dist: pytest-django<5.0,>=4.11; extra == 'test'
+Requires-Dist: pytest-mock<4.0,>=3.15; extra == 'test'
+Requires-Dist: pytest-xdist<4.0,>=3.8; extra == 'test'
+Requires-Dist: pytest<9.0,>=8.4; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Django-CFG: Type-Safe Django Configuration Framework with AI-Ready Infrastructure
+
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg?style=flat-square&logo=python)](https://www.python.org/downloads/)
+[![Django 5.2+](https://img.shields.io/badge/django-5.2+-green.svg?style=flat-square&logo=django)](https://www.djangoproject.com/)
+[![PyPI](https://img.shields.io/pypi/v/django-cfg.svg?style=flat-square&logo=pypi)](https://pypi.org/project/django-cfg/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Downloads](https://img.shields.io/pypi/dm/django-cfg.svg?style=flat-square)](https://pypi.org/project/django-cfg/)
+[![GitHub Stars](https://img.shields.io/github/stars/markolofsen/django-cfg?style=flat-square&logo=github)](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>