国产开源Django全栈AI脚手架，新手直接上手

DjangoStarter 是国内开发者开源维护、主打 Django+AI 一体化的企业级全栈项目脚手架，目前最新迭代至 V3 版本，专为独立开发者、中小型研发团队打造，完全适配 Django 5、兼容 Python 3.10～3.13 全版本。

区别于普通 Django 工具包、空白项目模板，它不是单一功能扩展包，而是预制全套业务+AI 底座的开箱项目模板：整合 Django Ninja 高性能 API、Tailwind 前端、向量库、异步队列、鉴权权限、LLM 对接能力，原生内置 AI 对话、私有化 RAG 知识库、大模型流式接口能力。

解决行业痛点

新建 Django AI 项目，需要反复配置环境、整合 LLM 依赖、搭建权限体系、对接向量库、编写流式接口。DjangoStarter 直接封装底层基建，开发者只需专注业务 AI 逻辑，适配私有化大模型、企业后台、智能客服、文档问答全场景，开源免费、商用无限制。

核心特点

1. 原生 AI 赋能，零代码对接大模型

• 内置统一 LLM 适配器，一键切换 DeepSeek、通义千问、OpenAI、Ollama 本地私有化模型
• 预制 RAG 全套能力：文档切片、向量入库、语义检索、权限隔离知识库，无需自研 LangChain 逻辑
• 原生支持打字机流式对话、会话记忆、聊天记录归档，适配前端 AI 聊天页面
• 自带 AI 接口鉴权、调用计费、次数统计，适配商业化 AI 项目开发

2. 架构升级：弃用 DRF，采用 Django Ninja

舍弃笨重 DRF，采用 Django Ninja 做 API 开发：依托 Python 类型注解，代码更简洁、接口性能更高，自动生成标准 OpenAPI 3 接口文档，无需额外配置 Swagger，前后端对接效率翻倍。

3. 全站基建预制，开箱即可上线

• 账号体系：自定义用户模型、邮箱登录、验证码登录、第三方登录、RBAC 细粒度权限
• 后台安全：Admin 登录验证码、防爆破 IP 拦截、接口限流、CSP 安全防护
• 工程配置：区分开发/测试/生产多环境、env 环境变量托管、日志结构化输出
• 前端配套：内置 HTMX + Alpine + Tailwind，无需独立前端项目，快速做交互页面

4. 配套工具齐全

• 异步任务：整合轻量任务队列，替代复杂 Celery，处理 AI 解析、文档异步向量化
• 文件存储：原生适配本地存储、阿里云 OSS、腾讯 COS 云端对象存储
• 快捷命令：内置代码生成指令，一键生成模型、接口、后台 CRUD 代码
• 容器化支持：自带 Docker 部署配置，一键打包上线

5. 轻量化易迁移

低耦合，可拆分抽取 AI 模块、权限模块嵌入现有 Django 老项目；无冗余重型依赖，低配服务器即可部署，个人开发、企业内网私有化部署都适配。

快速上手

环境要求

Python 3.10～3.13、Django 5.x、Git

第一步：克隆项目

# Gitee 国内极速克隆（推荐）
git clone https://gitee.com/deali/DjangoStarter.git
cd DjangoStarter

第二步：创建虚拟环境并安装依赖

python -m venv venv
# Windows
venv\Scripts\activate
# Mac/Linux
source venv/bin/activate

pip install -r requirements.txt

第三步：配置环境变量

cp .env.example .env
# 编辑 .env 文件，填写 AI 模型密钥

# 大模型配置
LLM_BASE_URL=https://api.deepseek.com
LLM_API_KEY=你的DeepSeek密钥
DEFAULT_LLM_MODEL=deepseek-chat

# 数据库配置
DB_ENGINE=postgres
DB_NAME=djangostarter
DB_USER=root
DB_PASSWORD=123456

第四步：启动项目

python manage.py migrate
python manage.py createsuperuser
python manage.py runserver

五大极简实战能力

1. 访问 AI 接口文档：http://127.0.0.1:8000/docs，可视化调试 AI 对话、文档上传、RAG 问答接口
2. 后端极简调用 AI 对话：

   from core.ai.llm_client import llm_chat
   result = llm_chat(prompt="帮我分析后台订单数据")
   # 流式问答
   stream_result = llm_chat(prompt="写一篇Django开发文案", stream=True)
   

3. 一键开启私有化 RAG：Admin 内置文档管理页面，上传 PDF/TXT/Word 自动切片向量化
4. 自定义 AI 权限管控：依托 RBAC 权限，可设置不同用户可用模型、每日调用次数、知识库访问权限
5. Docker 一键生产部署：docker-compose up -d

总结

DjangoStarter 是国产开源、面向 AI 业务的一体化 Django 脚手架，聚焦降低 Django+AI 开发门槛：

• 预制 RAG、流式 AI、多模型适配、权限后台、容器化部署全套能力
• 放弃老旧 DRF，使用 Django Ninja 提升接口性能
• 国内 Gitee 托管，下载部署速度快，适配私有化内网项目
• 适用人群：Django 新手开发者、不想重复搭建基建的全栈开发者、需要快速落地 AI 业务的研发小组、做私有化本地大模型项目团队

开源地址：https://gitee.com/deali/DjangoStarter
原文：公众号文章（mp.weixin.qq.com/s/_dbFmijXwGY4jZGfVA2_aA）