一键脚手架生成 FastAPI+Next.js AI Agent 全栈项目（含 RAG 与后台）

方案简介

vstorm-co/full-stack-ai-agent-template 是一个生产就绪的 全栈 AI Agent 项目生成器。它通过一个交互式向导（CLI 工具 fastapi-fullstack）一键脚手架出一套完整的 FastAPI 后端 + Next.js 15 前端应用，内置 5 套 AI Agent 框架、完整的 RAG 检索增强生成流水线，以及 20+ 企业级集成（鉴权、后台、任务队列、监控、容器化部署等）。

它解决的问题是：开发者想搭一个真正能上生产环境的 AI Agent / 聊天 / RAG 全栈应用时，往往要在后端框架、前端框架、Agent 库、向量库、鉴权、任务队列、部署脚本之间反复拼装，且大量样板代码雷同却必须从零写。本仓库把这套工程化样板封装成「模板+生成器+Makefile」的形式，让用户回答几个问题就能拿到一个能 make bootstrap 跑起来的项目骨架，再按需定制业务逻辑。

适合的受众是：希望快速验证 AI Agent 产品原型的工程师、需要内部知识库/对话系统的企业团队，以及想要一套带后台、JWT/OAuth、Celery、Docker、K8s 部署文件的「脚手架+最佳实践」参考架构的全栈开发者。

适合谁：需要把 AI Agent 能力以「前后端分离+后台+部署文件」一体化交付的团队。

前置要求

运行本模板需要以下前置条件：

• Python：用于安装并运行 fastapi-fullstack CLI（Python ≥ 3.10，建议使用 uv 管理）。
• Docker / Docker Compose：用于 make bootstrap 启动后端与 PostgreSQL 容器。
• Bun：用于本地启动 Next.js 前端（cd frontend && bun install && bun dev）。
• Make：执行 make bootstrap、make dev 等命令（make help 查看完整列表）。

安装 CLI 生成器：

# pip
pip install fastapi-fullstack

# uv (recommended)
uv tool install fastapi-fullstack

# pipx
pipx install fastapi-fullstack

Tip：不想装 CLI 的用户，可以直接使用 Web Configurator 在浏览器中配置并下载 ZIP。

使用与配置要点

日常使用与常用命令：

make dev           # bootstrap or restart (no admin re-seed)
make seed          # one-shot admin creation (no-op if admin exists)
make dev-down      # stop everything
make dev-logs      # tail container logs
make dev-rebuild   # force-rebuild backend image (after pyproject.toml changes)
make dev-frontend  # start the Next.js container

关键配置要点：

• 首次启动用 make bootstrap，它等价于 make dev + make seed，完成 Docker 构建、数据库迁移与默认管理员种子。
• 之后日常开发只需要 make dev（自动跳过管理员重新种子）。
• 修改了 pyproject.toml 等依赖文件后，需要 make dev-rebuild 强制重新构建后端镜像。
• 查看日志用 make dev-logs，停止服务用 make dev-down。
• 想看完整命令清单，在项目目录下执行 make help。
• 不想用 CLI 时，可以打开 Web Configurator 用浏览器勾选配置，直接下载 ZIP。

成功验证：

• 后端：http://localhost:8000/docs 能看到 OpenAPI/Swagger 页面。
• 后台：用 admin@example.com / admin123 能登录 http://localhost:8000/admin。
• 前端：http://localhost:3000 能看到聊天/对话界面。

优缺点

• ✓ 可视化 Web Configurator
• ✓ make bootstrap 一条命令完
• ✕ README 中部分组合（如 LangC

出处

本方案挖掘自开源项目 vstorm-co/full-stack-ai-agent-template，方案内容与实施命令均来自其 README 原文。