全栈 AI Agent 模板

这是一个生产就绪的 FastAPI + Next.js 项目生成器，集成了 AI Agents、RAG 以及 20 多种企业级集成。

快速开始 • 演示 • 文档 • 配置工具 • PyPI

---

🤖 6 种 AI Agent 框架 (PydanticAI, PydanticDeep, LangChain, LangGraph, CrewAI, DeepAgents)

📄 RAG 流水线 (Milvus, Qdrant, pgvector, ChromaDB)

⚡ FastAPI + Next.js 15 (WebSocket 流式传输，实时聊天 UI)

🔗 对话共享 (直接共享、公开链接、管理员浏览器)

🔒 企业级就绪 (JWT, OAuth, 后台管理面板, Celery, Docker, K8s)

目录

• 快速开始
• 演示
• 截图
• 为什么选择此模板
• 功能特性
• 架构
• AI Agent
• RAG (检索增强生成)
• 可观测性
• Django 风格 CLI
• 生成的项目结构
• 配置选项
• 对比
• 常见问题解答
• 文档
• 贡献指南

---

Vstorm 开源生态系统

此模板是生产级 AI Agent 开源生态系统的一部分：

项目	描述
pydantic-deepagents	Python 模块化 Agent 运行时。具备 Docker 沙箱、浏览器自动化、多 Agent 协作及 /improve 功能的 Claude Code 风格 CLI。
pydantic-ai-shields	Pydantic AI Agent 的即插即用安全护栏。包含 5 种基础设施防护和 5 种内容防护。
pydantic-ai-subagents	声明式多 Agent 编排，支持 Token 追踪。
summarization-pydantic-ai	针对长期运行的 Agent 的智能上下文压缩。
pydantic-ai-backend	AI Agent 的沙箱执行环境。Docker + Daytona。

想要了解该模板 AI Agent 背后的运行时吗？ pydantic-deepagents 为 deepagents 框架选项提供支持 —— 通过 curl -fsSL .../install.sh | bash 即可独立安装。

浏览所有项目：oss.vstorm.co

---

🚀 快速开始

[!TIP] 想要使用可视化配置器？ 使用 Web 配置工具 在浏览器中配置项目并下载 ZIP 包 —— 无需安装 CLI。

安装

# pip
pip install fastapi-fullstack

# uv (推荐)
uv tool install fastapi-fullstack

# pipx
pipx install fastapi-fullstack

创建项目

# 交互式向导 (推荐 — 默认运行)
fastapi-fullstack

# 快捷模式及选项
fastapi-fullstack create my_ai_app \
  --database postgresql \
  --frontend nextjs

# 使用预设进行常用配置
fastapi-fullstack create my_ai_app --preset production   # 完整的生产环境设置
fastapi-fullstack create my_ai_app --preset ai-agent     # 带流式传输的 AI Agent

# 最小化项目 (无额外功能)
fastapi-fullstack create my_ai_app --minimal

开始开发

首次克隆项目后

cd my_ai_app
make bootstrap       # = make dev + make seed

只需执行此操作，后端、数据库、Redis、向量数据库（如选择了 RAG）、Celery（如选择了该选项）就会启动，数据库迁移将自动应用，并初始化一个默认的管理员账户。

日常开发

make dev             # 幂等操作：构建 + 启动 + 迁移。可随时重新运行。

make dev 会跳过管理员种子的注入（该操作仅需在 make seed 时执行一次），因此在每次代码或配置修改后运行都非常高效。

幕后流程 (make dev):

1. 构建后端 Docker 镜像（首次运行后会缓存）
2. 通过 docker-compose.dev.yml 启动服务（热重载绑定挂载）
3. 轮询 Postgres 直到就绪 (pg_isready — 无固定等待时间)
4. 应用挂起的数据库迁移 (Alembic)