一条 CLI 生成 LangGraph 生产应用

想快速起一个能上线的 AI 应用，通常要自己拼 FastAPI、鉴权、WebSocket 流式输出、数据库迁移、前端聊天页，还要接 LangGraph 或 LangChain。社区项目 fastapi-fullstack（仓库 vstorm-co/full-stack-ai-agent-template）把这些收成一条 CLI：选好 AI 框架和依赖，直接生成可跑的 FastAPI + Next.js 工程。LangChain 官方也推过这个生成器。

当前 PyPI 版本在 0.2.x。MIT 许可。生成出来的是普通代码，不锁死在生成器上，后面可以随便改。

装 CLI

Python 3.11+。推荐用 uv 装成全局工具：

uv tool install fastapi-fullstack
# 或
pipx install fastapi-fullstack
# 或
pip install fastapi-fullstack

装完后终端里直接敲 fastapi-fullstack 会进入交互向导。也支持带参数非交互创建。

一条命令出脚手架

交互模式最省事：跟着问答题选数据库、前端、AI 框架、LLM 供应商就行。想直接上 LangGraph + Anthropic，可以写成：

fastapi-fullstack create my_ai_app \
  --ai-framework langgraph \
  --llm-provider anthropic \
  --database postgresql \
  --frontend nextjs

常用预设：

fastapi-fullstack create my_ai_app --preset ai-agent
fastapi-fullstack create my_ai_app --preset production
fastapi-fullstack create my_ai_app --preset production-saas
fastapi-fullstack create my_ai_app --minimal

ai-agent 偏流式对话和会话持久化。production 会带上 Redis、Sentry、K8s、Prometheus 一类生产件。production-saas 再叠账单、团队、管理后台。minimal 只留最薄的底座。

可选 AI 框架包括 PydanticAI、PydanticDeep、LangChain、LangGraph、DeepAgents。LLM 侧常见是 OpenAI、Anthropic、Google、OpenRouter（OpenRouter 主要跟 PydanticAI 搭配）。需要知识库时加 --rag，向量库可选 Milvus、Qdrant、ChromaDB、pgvector。

不想装 CLI 也可以用官方的 Web Configurator，在浏览器里勾选项，下载 ZIP。

本地跑通

生成目录后：

cd my_ai_app
make bootstrap

make bootstrap 会起 Docker 里的后端和 PostgreSQL、跑 Alembic 迁移、种默认管理员（常见是 admin@example.com / admin123，进系统后马上改）。前端另开终端：

cd frontend
bun install
bun dev

日常重启用 make dev。停掉用 make dev-down，看日志用 make dev-logs。改了 pyproject.toml 再 make dev-rebuild。

后端默认带 OpenAPI。前端是 Next.js 15 + React 19，聊天页走 WebSocket 流式输出，工具调用会拆成卡片展示。

生成出来有什么

后端是分层结构：路由、Service、Repository，再加 agents、RAG、worker。每个项目还有 Django 风格的管理 CLI，名字跟你的 project_slug 一致，例如：

cd backend
uv run my_ai_app server run --reload
uv run my_ai_app db migrate -m "add users"
uv run my_ai_app db upgrade
uv run my_ai_app user create-admin

鉴权支持 JWT、刷新令牌、API Key、Google OAuth。后台任务可选 Celery、Taskiq、ARQ、Prefect。观测方面，PydanticAI 路线偏 Logfire，LangChain / LangGraph 路线偏 LangSmith。选 LangChain 或 LangGraph 时，环境变量里通常会看到 LANGCHAIN_TRACING_V2、LANGCHAIN_API_KEY、LANGCHAIN_PROJECT。

前端不止聊天：仪表盘、知识库、设置、深色模式、可选营销站和 Stripe 账单。生成物里还带 CLAUDE.md、AGENTS.md，以及按选项裁剪过的 .claude/skills，方便用编码代理继续改这个仓库。

升级老项目

脚手架不是一次性的。项目里可以用：

make upgrade-dry-run
make upgrade
# 冲突在 IDE 里三路合并后
make upgrade-finalize

改动落在 template-upgrade/v… 分支，可回滚。想顺带接新可选功能，用 make upgrade-new-features。

什么时候用

适合想尽快验证「带鉴权、流式对话、可观测的 Agent 产品」的团队，尤其已经定了 FastAPI + Next.js，并且想直接挂 LangGraph ReAct 或 LangChain 链路。它帮你把管道先搭好，真正要花时间的还是业务工具、提示词和评测。

不适合只想写一个裸脚本调模型的场景。那用官方 LangGraph 或 langgraph new 更轻。也不要把生成器当成运行时依赖：生成完就是你的代码，后续维护按普通仓库走。

文档入口：Quick Start、GitHub README、PyPI。