能力标签
全栈AI代理模板
⚙️
Agent工作流

全栈AI代理模板

基于 Python · 无代码搭建完整 AI 自动化流程
英文名:full-stack-ai-agent-template
⭐ 1.3k Stars 🍴 261 Forks 💻 Python 📄 MIT 🏷 AI 8.0分
8.0AI 综合评分
AI代理模板FastAPINext.js
✦ AI Skill Hub 推荐

AI Skill Hub 强烈推荐:全栈AI代理模板 是一款优质的Agent工作流。已获得 1.3k 颗 GitHub Star,AI 综合评分 8.0 分,在同类工具中表现稳健。如果你正在寻找可靠的Agent工作流解决方案,这是一个值得深入了解的选择。

📚 深度解析

全栈AI代理模板 是一套完整的 AI Agent 自动化工作流方案。随着 AI 能力的不断提升,基于 Agent 的自动化工作流正在成为提升个人和团队效率的核心方式。区别于传统的 RPA 自动化(模拟鼠标键盘操作),AI Agent 工作流通过理解任务意图、动态规划执行路径,能够处理更复杂的非结构化任务。

全栈AI代理模板 工作流的设计遵循"最小配置,最大复用"原则:核心逻辑已经封装好,用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制,在网络波动或 API 限速等情况下仍能稳定运行,适合作为生产环境的自动化基础设施。

在实际部署时,建议先在测试环境中运行 3-5 次,验证各个环节的输出结果符合预期,再部署到生产环境。AI Skill Hub 评分 8.0 分,是同类 Agent 工作流中的精选推荐。

📋 工具概览

快速生成AI应用,集成FastAPI和Next.js

全栈AI代理模板 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排,将复杂的多步骤任务拆解为清晰的自动化流程,实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成,适合构建数据处理管线、业务自动化和 AI 辅助决策系统。

GitHub Stars
⭐ 1.3k
开发语言
Python
支持平台
Windows / macOS / Linux
维护状态
正常维护,社区驱动
开源协议
MIT
AI 综合评分
8.0 分
工具类型
Agent工作流
Forks
261

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理,如需查看完整原始文档请访问底部「原始来源」。

快速生成AI应用,集成FastAPI和Next.js

全栈AI代理模板 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排,将复杂的多步骤任务拆解为清晰的自动化流程,实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成,适合构建数据处理管线、业务自动化和 AI 辅助决策系统。

📌 核心特色
  • 可视化 Agent 工作流编排,无需编写复杂代码
  • 支持多步骤自动化任务链,实现全流程无人值守
  • 与外部 API、数据库和第三方服务无缝集成
  • 内置错误处理与自动重试机制,保障稳定运行
  • 提供可复用的自动化模板,快速在同类场景部署
🎯 主要使用场景
  • 自动化日常重复性工作,将精力集中于创造性任务
  • 构建数据采集 → 处理 → 输出的完整自动化管线
  • 实现跨平台、跨系统的数据流转和业务协同
以下安装命令基于项目开发语言和类型自动生成,实际以官方 README 为准。
安装命令
# 方式一:pip 安装(推荐)
pip install full-stack-ai-agent-template

# 方式二:虚拟环境安装(推荐生产环境)
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install full-stack-ai-agent-template

# 方式三:从源码安装(获取最新功能)
git clone https://github.com/vstorm-co/full-stack-ai-agent-template
cd full-stack-ai-agent-template
pip install -e .

# 验证安装
python -c "import full_stack_ai_agent_template; print('安装成功')"
📋 安装步骤说明
  1. 访问 GitHub 仓库获取工作流文件
  2. 在对应平台(Dify / Flowise / Make 等)中找到「导入工作流」功能
  3. 上传工作流文件
  4. 按照提示配置必要的环境变量和 API Key
  5. 运行测试确认流程正常后投入使用
以下用法示例由 AI Skill Hub 整理,涵盖最常见的使用场景。
常用命令 / 代码示例
# 命令行使用
full-stack-ai-agent-template --help

# 基本用法
full-stack-ai-agent-template input_file -o output_file

# Python 代码中调用
import full_stack_ai_agent_template

# 示例
result = full_stack_ai_agent_template.process("input")
print(result)
以下配置示例基于典型使用场景生成,具体参数请参照官方文档调整。
配置示例
# full-stack-ai-agent-template 配置文件示例(config.yml)
app:
  name: "full-stack-ai-agent-template"
  debug: false
  log_level: "INFO"

# 运行时指定配置文件
full-stack-ai-agent-template --config config.yml

# 或通过环境变量配置
export FULL_STACK_AI_AGENT_TEMPLATE_API_KEY="your-key"
export FULL_STACK_AI_AGENT_TEMPLATE_OUTPUT_DIR="./output"
📑 README 深度解析 真实文档 完整度 94/100 含工作流图 查看 GitHub 原文 →
以下内容由系统直接从 GitHub README 解析整理,保留代码块、表格与列表结构。

简介

Full-Stack AI Agent Template

<p align="center"> <i>Production-ready FastAPI + Next.js project generator with AI agents, RAG, and 20+ enterprise integrations.</i> </p>

<p align="center"> <a href="#-quick-start">Quick Start</a> • <a href="#-features">Features</a> • <a href="#-demo">Demo</a> • <a href="https://vstorm-co.github.io/full-stack-ai-agent-template/">Documentation</a> • <a href="https://oss.vstorm.co/projects/full-stack-ai-agent-template/configurator/">Configurator</a> • <a href="https://pypi.org/project/fastapi-fullstack/">PyPI</a> </p>

<p align="center"> <a href="https://pypi.org/project/fastapi-fullstack/"><img src="https://img.shields.io/pypi/v/fastapi-fullstack?color=green&logo=pypi&logoColor=white" alt="PyPI"></a> <a href="https://pepy.tech/projects/fastapi-fullstack"><img src="https://static.pepy.tech/badge/fastapi-fullstack/month" alt="PyPI Downloads"></a> <a href="https://github.com/vstorm-co/full-stack-ai-agent-template/stargazers"><img src="https://img.shields.io/github/stars/vstorm-co/full-stack-ai-agent-template?style=flat&logo=github&color=yellow" alt="GitHub Stars"></a> <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.11+-blue?logo=python&logoColor=white" alt="Python 3.11+"></a> <a href="https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/LICENSE"><img src="https://img.shields.io/github/license/vstorm-co/full-stack-ai-agent-template?color=blue" alt="License"></a> <img src="https://img.shields.io/badge/coverage-100%25-brightgreen" alt="Coverage"> <a href="https://github.com/vstorm-co/full-stack-ai-agent-template/actions/workflows/ci.yml"><img src="https://github.com/vstorm-co/full-stack-ai-agent-template/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/SECURITY.md"><img src="https://img.shields.io/badge/security-policy-blueviolet?logo=shieldsdotio&logoColor=white" alt="Security Policy"></a> <a href="https://www.bestpractices.dev/projects/12539"><img src="https://www.bestpractices.dev/projects/12539/badge" alt="OpenSSF Best Practices"></a> <a href="https://github.com/pydantic/pydantic-ai"><img src="https://img.shields.io/badge/Powered%20by-Pydantic%20AI-E92063?logo=pydantic&logoColor=white" alt="Pydantic AI"></a> <a href="https://x.com/Kacper95682155"><img src="https://img.shields.io/badge/X-000000?logo=x&logoColor=white" alt="X"></a> </p>

<p align="center"> <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new3/chat_demo_with_tasks.gif" alt="AI chat with live plan & task checklist" width="100%"> </p>

<p align="center"> <b>🤖 5 AI Agent Frameworks</b> <i>(PydanticAI, PydanticDeep, LangChain, LangGraph, DeepAgents)</i> <br> <b>📄 RAG Pipeline</b> <i>(Milvus, Qdrant, pgvector, ChromaDB)</i> <br> <b>⚡ FastAPI + Next.js 15</b> <i>(WebSocket streaming, real-time chat UI)</i> <br> <b>🔗 Conversation Sharing</b> <i>(direct sharing, public links, admin browser)</i> <br> <b>🔒 Enterprise-Ready</b> <i>(JWT, OAuth, admin panel, Celery, Docker, K8s)</i> </p>

<details> <summary><b>Table of Contents</b></summary>

</details>

---

🗺️ Architecture Overview

┌──────────────────────────────────────────────────────────────────────────┐
│                         FRONTEND  (Next.js 15)                           │
│  Chat UI · Knowledge Base · Dashboard · Settings · Dark Mode · i18n      │
└──────────────┬───────────────────────────────────────────┬───────────────┘
               │  REST / WebSocket                         │  Vercel
               ▼                                           ▼
┌──────────────────────────────────────────────────────────────────────────┐
│                         BACKEND  (FastAPI)                               │
│                                                                          │
│  ┌─────────────────────────────────────────────────────────────────┐     │
│  │                     AI AGENTS                                   │     │
│  │  PydanticAI · LangChain · LangGraph · DeepAgents                │     │
│  │  ────────────────────────────────────────────────────────────   │     │
│  │  Tools: datetime · web_search (Tavily) · search_knowledge_base  │     │
│  │  Providers: OpenAI · Anthropic · Gemini · OpenRouter            │     │
│  └─────────────────────────────────────────────────────────────────┘     │
│                                                                          │
│  ┌─────────────────────────────────────────────────────────────────┐     │
│  │                     RAG PIPELINE                                │     │
│  │                                                                 │     │
│  │  Sources        Parse           Chunk          Embed            │     │
│  │  ─────────      ──────────      ──────────     ──────────────   │     │
│  │  Local files    PyMuPDF         recursive      OpenAI           │     │
│  │  API upload     LiteParse       markdown       Voyage           │     │
│  │  Google Drive   LlamaParse      fixed          Gemini (multi)   │     │
│  │  S3/MinIO       python-docx                    SentenceTransf.  │     │
│  │  Sync Sources                                                   │     │
│  │                                                                 │     │
│  │  Store              Search              Rank                    │     │
│  │  ──────────────     ──────────────      ──────────────          │     │
│  │  Milvus             Vector similarity   Cohere reranker         │     │
│  │  Qdrant             BM25 + vector RRF   CrossEncoder            │     │
│  │  ChromaDB           Multi-collection                            │     │
│  │  pgvector                                                       │     │
│  └─────────────────────────────────────────────────────────────────┘     │
│                                                                          │
│  Auth (JWT/API Key/OAuth) · Rate Limiting · Webhooks · Admin Panel       │
│  Billing (Stripe + credits) · Background Tasks (Celery/Taskiq/ARQ/       │
│  Prefect) · Django-style CLI · Observability (Logfire/LangSmith/         │
│  Sentry/Prometheus)                                                      │
└───────┬──────────────┬──────────────┬──────────────┬─────────────────────┘
        │              │              │              │
        ▼              ▼              ▼              ▼
   PostgreSQL       Redis         Vector DB      LLM APIs
   (async)                        (Milvus/       (OpenAI/
                                  Qdrant/        Anthropic/
                                  ChromaDB/      Gemini)
                                  pgvector)

---

✨ Features

<p align="center"> <a href="https://ai.pydantic.dev"><img src="https://img.shields.io/badge/PydanticAI-E92063?logo=pydantic&logoColor=white" alt="PydanticAI"></a> <a href="https://python.langchain.com"><img src="https://img.shields.io/badge/LangChain-1C3C3C?logo=langchain&logoColor=white" alt="LangChain"></a> <a href="https://langchain-ai.github.io/langgraph/"><img src="https://img.shields.io/badge/LangGraph-005A9C?logo=langchain&logoColor=white" alt="LangGraph"></a> <a href="https://milvus.io"><img src="https://img.shields.io/badge/Milvus-FF6B35?logoColor=white" alt="Milvus"></a> <a href="https://openai.com"><img src="https://img.shields.io/badge/OpenAI-412991?logo=openai&logoColor=white" alt="OpenAI"></a> <a href="https://anthropic.com"><img src="https://img.shields.io/badge/Anthropic-D4A373?logo=anthropic&logoColor=white" alt="Anthropic"></a> <a href="https://ai.google.dev"><img src="https://img.shields.io/badge/Gemini-4285F4?logo=google&logoColor=white" alt="Google Gemini"></a> <a href="https://openrouter.ai"><img src="https://img.shields.io/badge/OpenRouter-6366F1?logoColor=white" alt="OpenRouter"></a> </p>

<p align="center"> <a href="https://fastapi.tiangolo.com"><img src="https://img.shields.io/badge/FastAPI-009688?logo=fastapi&logoColor=white" alt="FastAPI"></a> <a href="https://nextjs.org"><img src="https://img.shields.io/badge/Next.js_15-000000?logo=next.js&logoColor=white" alt="Next.js 15"></a> <a href="https://react.dev"><img src="https://img.shields.io/badge/React_19-61DAFB?logo=react&logoColor=black" alt="React 19"></a> <a href="https://www.typescriptlang.org"><img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white" alt="TypeScript"></a> <a href="https://tailwindcss.com"><img src="https://img.shields.io/badge/Tailwind_v4-06B6D4?logo=tailwindcss&logoColor=white" alt="Tailwind CSS"></a> <a href="https://www.sqlalchemy.org"><img src="https://img.shields.io/badge/SQLAlchemy-D71F00?logo=sqlalchemy&logoColor=white" alt="SQLAlchemy"></a> </p>

<p align="center"> <a href="https://www.postgresql.org"><img src="https://img.shields.io/badge/PostgreSQL-4169E1?logo=postgresql&logoColor=white" alt="PostgreSQL"></a> <a href="https://redis.io"><img src="https://img.shields.io/badge/Redis-DC382D?logo=redis&logoColor=white" alt="Redis"></a> <a href="https://milvus.io"><img src="https://img.shields.io/badge/Milvus-00A1EA?logoColor=white" alt="Milvus"></a> <a href="https://qdrant.tech"><img src="https://img.shields.io/badge/Qdrant-FF6B6B?logoColor=white" alt="Qdrant"></a> <a href="https://www.trychroma.com"><img src="https://img.shields.io/badge/ChromaDB-FF6F61?logoColor=white" alt="ChromaDB"></a> <a href="https://docs.celeryq.dev"><img src="https://img.shields.io/badge/Celery-37814A?logo=celery&logoColor=white" alt="Celery"></a> <a href="https://www.prefect.io"><img src="https://img.shields.io/badge/Prefect-070E10?logo=prefect&logoColor=white" alt="Prefect"></a> <a href="https://logfire.pydantic.dev"><img src="https://img.shields.io/badge/Logfire-E92063?logo=pydantic&logoColor=white" alt="Logfire"></a> <a href="https://sentry.io"><img src="https://img.shields.io/badge/Sentry-362D59?logo=sentry&logoColor=white" alt="Sentry"></a> <a href="https://prometheus.io"><img src="https://img.shields.io/badge/Prometheus-E6522C?logo=prometheus&logoColor=white" alt="Prometheus"></a> </p>

<p align="center"> <a href="https://www.docker.com"><img src="https://img.shields.io/badge/Docker-2496ED?logo=docker&logoColor=white" alt="Docker"></a> <a href="https://kubernetes.io"><img src="https://img.shields.io/badge/Kubernetes-326CE5?logo=kubernetes&logoColor=white" alt="Kubernetes"></a> <a href="https://github.com/features/actions"><img src="https://img.shields.io/badge/GitHub_Actions-2088FF?logo=githubactions&logoColor=white" alt="GitHub Actions"></a> <a href="https://aws.amazon.com/s3/"><img src="https://img.shields.io/badge/S3-569A31?logo=amazons3&logoColor=white" alt="S3"></a> </p>

Features

  • Document parsing - PDF (PyMuPDF with tables, headers/footers, OCR), DOCX, TXT, MD + 130+ formats via LlamaParse
  • Image description - Extract images from documents, describe via LLM vision API (opt-in)
  • Chunking - RecursiveCharacterTextSplitter with configurable size/overlap
  • Reranking - Cohere API or local CrossEncoder for improved search quality
  • Agent integration - All 5 AI frameworks get a search_knowledge_base tool automatically

---

Installation

```bash

Bare-bones project (PostgreSQL, no Docker/Redis/CI)

fastapi-fullstack create my_ai_app --minimal ```

</details>

4. Build WebSocket streaming for AI responses

8. Build Next.js frontend with auth and chat UI

9. Write Docker Compose for all services

🚀 Quick Start

[!TIP] Prefer a visual configurator? Use the Web Configurator to configure your project in the browser and download a ZIP — no CLI installation needed.

Billing & Usage

Billing overview — current plan, seats, storage usage, Customer Portal link.

Billing and usage

</td> <td width="50%">

Usage charts — daily credits-spent + call-count charts, by-model token breakdown.

Billing usage charts

</td> </tr> <tr> <td width="50%">

Credits — balance, immutable transaction ledger, usage sparkline.

Billing credits

</td> <td width="50%">

Subscription & invoices — plan management, invoice list, payment methods — all via Stripe.

Billing subscription

</td> </tr> </table>

Usage

```python

🎬 Demo

CLI generator — configure and scaffold a full-stack AI project in under 60 seconds:

CLI generator demo

AI chat — streaming responses, tool calls, reasoning, and ask-user pauses:

AI chat demo

</td> <td width="50%">

RAG ingestion — drop a document, watch it get chunked, embedded, and answered against:

RAG demo

</td> </tr> </table>

Generated marketing site — public landing page with hero, pricing, blog, and legal pages (enable_marketing_site):

Landing demo

---

📸 Screenshots

Non-interactive with explicit options

fastapi-fullstack create my_ai_app --database postgresql --frontend nextjs

Environments

make targetCompose fileWhen to use
make devdocker-compose.dev.ymlLocal development with hot-reload + bind-mounted source.
make stagedocker-compose.ymlProduction-like build (no bind mounts) running on localhost. Sanity-check before deploy.
make proddocker-compose.prod.ymlProduction. Requires backend/.env (copy from backend/.env.example, fill real secrets) + external Nginx using nginx/nginx.conf.

Each env has matching -down, -logs, -rebuild siblings.

[!NOTE] Windows users: make requires GNU Make. Install via Chocolatey (choco install make) or use WSL2 / Git Bash. The Docker workflow is identical across macOS, Linux, and WSL2.

<details> <summary><b>Local backend (no Docker, for IDE breakpoints)</b></summary>

If you want to run the backend on the host while the database stays in Docker:

```bash cd my_ai_app make install # uv sync + pre-commit hooks

Configure your nginx host using nginx/nginx.conf as reference

make prod # builds + starts + migrates make prod-logs # tail logs


For frontend deployment to **Vercel**:
bash cd frontend && npx vercel --prod ```

In the Vercel dashboard set BACKEND_URL, BACKEND_WS_URL, NEXT_PUBLIC_AUTH_ENABLED=true.

</details>

Profile & Settings

Profile — avatar upload, display name, email, active sessions with per-device revoke.

Profile

</td> <td width="50%">

Account & security — password change, "sign out everywhere", account deletion zone.

Account

</td> </tr> <tr> <td width="50%">

Slash commands — toggle built-ins, create custom prompt shortcuts for the chat palette.

Slash Commands

</td> <td width="50%">

Appearance — light/dark/system theme + brand color picker (5 presets, saved per-device).

Appearance

</td> </tr> </table>

.env

LANGCHAIN_TRACING_V2=true LANGCHAIN_API_KEY=your-api-key LANGCHAIN_PROJECT=my_project ```

Configuration

Enable Logfire and select which components to instrument:

```bash fastapi-fullstack new

⚙️ Configuration Options

Core Options

OptionValuesDescription
**Database**postgresql, noneAsync PostgreSQL (SQLAlchemy 2.0 + Alembic)
**ORM**sqlalchemy, sqlmodelSQLModel for simplified syntax
**Auth**jwt, api_key, both, noneJWT includes user management
**OAuth**none, googleSocial login
**AI Framework**pydantic_ai, pydantic_deep, langchain, langgraph, deepagentsChoose your AI agent framework
**LLM Provider**openai, anthropic, google, openrouterOpenRouter only with PydanticAI
**RAG**--ragEnable RAG with vector database
**Vector Store**milvus, qdrant, chromadb, pgvectorpgvector uses existing PostgreSQL
**Background Tasks**none, celery, taskiq, arq, prefectDistributed queues / orchestration
**Frontend**none, nextjsNext.js 15 + React 19

2. Configure SQLAlchemy + Alembic migrations

7. Configure Celery + Redis for background tasks

Done. All of the above, configured and working.

```

Presets for common scenarios (run `fastapi-fullstack templates` for the full list)

fastapi-fullstack create my_ai_app --preset ai-agent # AI agent with streaming fastapi-fullstack create my_ai_app --preset production # Full production setup fastapi-fullstack create my_ai_app --preset production-saas # SaaS: billing, teams, admin

The CLI command is: uv run <project_slug> <command>

uv run my_ai_app server run --reload # Start dev server uv run my_ai_app db migrate -m "message" # Create migration uv run my_ai_app db upgrade # Apply migrations uv run my_ai_app user create-admin # Create admin user ```

Use make help to see all available Makefile shortcuts.

---

⚡ Backend (FastAPI)

  • FastAPI + Pydantic v2 - High-performance async API
  • PostgreSQL (async) - SQLAlchemy 2.0 + Alembic migrations, pgvector-ready
  • Authentication - JWT + Refresh tokens, API Keys, OAuth2 (Google)
  • Background Tasks - Celery, Taskiq, ARQ, or Prefect
  • Django-style CLI - Custom management commands with auto-discovery

✓ Instrument FastAPI

✓ Rate limiting (slowapi)

✓ Pagination (fastapi-pagination)

1. Set up FastAPI project structure

🔌 20+ Enterprise Integrations

CategoryIntegrations
**AI Frameworks**PydanticAI, PydanticDeep, LangChain, LangGraph, DeepAgents
**LLM Providers**OpenAI, Anthropic, Google Gemini, OpenRouter
**RAG / Vector Stores**Milvus, Qdrant, ChromaDB, pgvector
**RAG Sources**Local files, API upload, Google Drive, S3/MinIO, Sync Sources (per-org UI, scheduled)
**Embeddings**OpenAI, Voyage, Gemini (multimodal), SentenceTransformers
**Background Tasks**Celery, Taskiq, ARQ, Prefect
**Billing**Stripe subscriptions (seat-based), credits + usage metering, invoices, Customer Portal
**Caching & State**Redis, fastapi-cache2
**Security**Rate limiting, CORS, CSRF protection
**Observability**Logfire, LangSmith, Sentry, Prometheus
**Admin**SQLAdmin panel with auth
**Collaboration**Conversation sharing (direct + link), admin conversation browser
**Messaging**Telegram multi-bot (polling + webhook), Slack multi-bot (Events API + Socket Mode)
**Events**Webhooks, WebSockets
**DevOps**Docker, GitHub Actions, GitLab CI, Kubernetes

PydanticAI Integration

Type-safe agents with full dependency injection:

```python

LangChain Integration

Flexible agents with LangGraph:

```python

Integrations

Select what you need:

```bash fastapi-fullstack new

6. Set up RAG pipeline (parsing, chunking, embedding, vector store)

🔄 Comparison

vs. Manual Setup

Setting up a production AI agent stack manually means wiring together 10+ tools yourself:

```bash

vs. Alternatives

Feature**This Template**[full-stack-fastapi-template](https://github.com/fastapi/full-stack-fastapi-template)[create-t3-app](https://github.com/t3-oss/create-t3-app)
**AI Agents** (5 frameworks)
**RAG Pipeline** (4 vector stores)
**WebSocket Streaming**
**Conversation Persistence**
**LLM Observability** (Logfire/LangSmith)
**FastAPI Backend**
**Next.js Frontend**✅ (v15)
**JWT + OAuth Authentication**✅ (NextAuth)
**Background Tasks** (Celery/Taskiq/ARQ/Prefect)✅ (Celery)
**Billing & Credits** (Stripe + usage metering)
**Admin Panel**✅ (SQLAdmin)
**Async PostgreSQL** (SQLAlchemy 2.0 + pgvector)Prisma
**Docker + K8s**
**Interactive CLI Wizard**
**Django-style Commands**
**Document Sources** (GDrive, S3, API)
**AI-Agent Friendly** (CLAUDE.md)

---

❓ FAQ

<details> <summary><b>How is this different from full-stack-fastapi-template?</b></summary>

full-stack-fastapi-template by @tiangolo is a great starting point for FastAPI projects, but it focuses on traditional web apps. This template is purpose-built for AI/LLM applications — it adds AI agents (5 frameworks), RAG with 4 vector stores, WebSocket streaming, conversation persistence, LLM observability, and a Next.js chat UI out of the box.

</details>

<details> <summary><b>Can I use this without AI/LLM features?</b></summary>

Yes. The AI agent and RAG modules are optional. You can use this as a pure FastAPI + Next.js template with auth, admin panel, background tasks, and all other infrastructure — just skip the AI framework selection during setup.

</details>

<details> <summary><b>What Python and Node.js versions are required?</b></summary>

Python 3.11+ and Node.js 18+ (for the Next.js frontend). We recommend using uv for Python and bun for the frontend.

</details>

<details> <summary><b>Can I add integrations after project generation?</b></summary>

The generated project is plain code — no lock-in or runtime dependency on the generator. You can add, remove, or modify any integration manually. The template just gives you a well-structured starting point.

</details>

<details> <summary><b>Can I use a different LLM provider than the one I selected?</b></summary>

Yes. The LLM provider is configured via environment variables (AI_MODEL, OPENAI_API_KEY, etc.). You can switch providers by changing the .env file and the model name — no code changes needed for PydanticAI (which supports all providers natively).

</details>

---

🇨🇳 中文文档镜像 AI 翻译 2026-05-28
英文原文章节由系统翻译为中文摘要,便于快速理解。完整原文见上方 "📑 README 深度解析"。
📌 简介

Full-Stack AI Agent Template 是一个专为生产环境设计的项目生成器,集成了 FastAPI 后端与 Next.js 前端。它不仅支持构建高性能的 Web 应用,还深度集成了 AI Agent、RAG(检索增强生成)能力以及超过 20 种企业级服务。通过该模板,开发者可以快速搭建具备聊天界面、知识库管理、仪表盘及多语言支持的智能化应用,实现从前端 UI 到后端 AI 逻辑的完整闭环。

⚡ 功能介绍

本���目提供了强大的 AI 与文档处理能力。支持通过 PyMuPDF 和 LlamaParse 解析 PDF、DOCX、MD 等 130 多种格式,并具备 OCR 与图像描述功能(通过 LLM vision API)。在 RAG 工作流中,支持使用 RecursiveCharacterTextSplitter 进行分块,并集成 Cohere API 或本地 CrossEncoder 进行 Reranking 以提升搜索精度。此外,深度集成了 PydanticAI、LangChain 和 LangGraph 等主流 AI 框架,确保 Agent 开发的安全与灵活。

🛠 安装步骤(Docker/pip/源码)

开发者可以通过 CLI 工具快速创建项目。使用 `fastapi-fullstack create` 命令并配合 `--preset` 参数(如 `production` 或 `ai-agent`)来生成预设配置。对于需要流式响应的 AI Agent 场景,建议使用 `ai-agent` 预设。项目支持 Docker 环境,通过 Makefile 可以轻松管理开发、测试与生产环境的构建流程。

🚀 使用教程

项目提供了极高的上手便利性。如果你更倾向于可视化操作,可以使用 Web Configurator 在浏览器中直接配置项目并下载 ZIP 包,无需安装 CLI。对于开发者,可以通过 `uv run` 命令启动开发服务器,并利用 Makefile 提供的快捷指令进行数据库迁移、用户管理及日志查看,实现高效的开发迭代。

⚙️ 配置说明(含 MCP / env)

项目通过环境变量与 Makefile 实��多环境管理。使用 `make dev` 进行带热重载的本地开发,`make stage` 用于模拟生产环境进行上线前检查,`make prod` 则用于构建完整的生产环境镜像。前端部署至 Vercel 时,需配置 `BACKEND_URL`、`BACKEND_WS_URL` 及 `NEXT_PUBLIC_AUTH_ENABLED` 等关键环境变量,以确保前后端通信正常。

🔌 API 说明

后端管理与监控功能完备。通过 `uv run <project_slug>` 命令可以执行数据库迁移(migrate/upgrade)及管理员创建等操作。系统集成了 Celery Flower,提供实时的任务队列监控,方便开发者追踪文档摄取、邮件发送及 Webhooks 等后台任务的状态、吞吐量及失败率。同时,API 文档会自动生成,方便前后端联调。

🔄 工作流/模块

模板内置了超过 20 种企业级集成,涵盖了 AI 框架(PydanticAI, LangChain, LangGraph, CrewAI)、LLM 提供商(OpenAI, Anthropic, Google Gemini, OpenRouter)以及向量数据库(Milvus, Qdrant, ChromaDB, pgvector)。��过类型安全的依赖注入与灵活的 Agent 编排,开发者可以轻松构建从文档解析到复杂逻辑推理的完整 AI 工作流。

❓ FAQ 摘要

本项目与传统的 `full-stack-fastapi-template` 有显著区别:后者侧重于传统 Web 应用的架构,而本模板专为 AI 驱动的应用设计,内置了复杂的 RAG 工作流、Agent 集成以及针对 AI 交互优化的前端 UI,能够更快速地满足现代 AI 原生应用的开发需求。

🎯 aiskill88 AI 点评 A 级 2026-05-27

高质量的全栈AI代理模板,易于使用

📚 实用指南(长尾问题)
适合谁
  • 构建多智能体协作系统的 Agent 开发者
  • 构建企业知识库 / RAG 检索应用的团队
  • 需要从图片、PDF 提取文字的文档自动化场景
  • 跨境业务、多语言内容运营团队
最佳实践
  • 生产部署优先使用 Docker Compose 隔离依赖,并挂载 volume 持久化数据
  • 分块大小建议 256-512 tokens,向量库优选 pgvector 或 Qdrant
  • Agent 任务先做 dry-run 验证工具调用链,再开启自主执行
常见错误
  • API key 直接提交到 git 仓库(请用 .env 并加入 .gitignore)
  • 容器内无法访问宿主机 localhost — 使用 host.docker.internal
  • embedding 模型与查询模型不一致导致检索失效
  • Python 依赖冲突:建议用 venv / uv 隔离环境
部署方案
  • Docker:full-stack-ai-agent-template 提供官方镜像,docker compose up 一键启动
  • CLI:直接 npm install -g / pip install,命令行调用
  • 云端托管:可放在 Vercel / Railway / Fly.io 等 PaaS 平台

⚡ 核心功能

  • 可视化 Agent 工作流编排,无需编写复杂代码
  • 支持多步骤自动化任务链,实现全流程无人值守
  • 与外部 API、数据库和第三方服务无缝集成
  • 内置错误处理与自动重试机制,保障稳定运行
  • 提供可复用的自动化模板,快速在同类场景部署
👥 适合谁
  • 构建多智能体协作系统的 Agent 开发者
  • 构建企业知识库 / RAG 检索应用的团队
  • 需要从图片、PDF 提取文字的文档自动化场景
  • 跨境业务、多语言内容运营团队
⭐ 最佳实践
  • 生产部署优先使用 Docker Compose 隔离依赖,并挂载 volume 持久化数据
  • 分块大小建议 256-512 tokens,向量库优选 pgvector 或 Qdrant
  • Agent 任务先做 dry-run 验证工具调用链,再开启自主执行
⚠️ 常见错误
  • API key 直接提交到 git 仓库(请用 .env 并加入 .gitignore)
  • 容器内无法访问宿主机 localhost — 使用 host.docker.internal
  • embedding 模型与查询模型不一致导致检索失效
  • Python 依赖冲突:建议用 venv / uv 隔离环境

👥 适合人群

自动化工程师和运维人员项目经理和业务分析师希望减少重复性工作的专业人士数字化转型团队

🎯 使用场景

  • 自动化日常重复性工作,将精力集中于创造性任务
  • 构建数据采集 → 处理 → 输出的完整自动化管线
  • 实现跨平台、跨系统的数据流转和业务协同

⚖️ 优点与不足

✅ 优点
  • +MIT 协议,可免费商用
  • +大幅减少重复性人工操作
  • +可视化流程,清晰直观
  • +可扩展性强,支持复杂场景
⚠️ 不足
  • 初始配置和调试需投入一定时间
  • 强依赖外部服务的稳定性
  • 复杂场景需具备一定技术基础
⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台,本页面信息基于公开数据整理,不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后,再部署至生产环境,并做好必要的安全评估。

📄 License 说明

✅ MIT 协议 — 最宽松的开源协议之一,可自由商用、修改、分发,仅需保留版权声明。

❓ 常见问题 FAQ

full-stack-ai-agent-template 是一款Python开发的AI辅助工具。开源AI工作流:Full-stack AI app generator — FastAPI + Next.js with AI Agents, RAG, streaming, 。⭐1.3k · Python 主要应用场景包括:快速构建AI应用。
💡 AI Skill Hub 点评

总体来看,全栈AI代理模板 是一款质量优秀的Agent工作流,在同类工具中具备一定竞争力。AI Skill Hub 将持续追踪其更新动态,建议收藏备用,结合自身场景选择合适时机引入使用。

⬇️ 获取与下载
⬇ 下载源码 ZIP

✅ MIT 协议 · 可免费商用 · 直接从 aiskill88 服务器下载,无需跳转 GitHub

📚 深入学习 全栈AI代理模板
查看分步骤安装教程和完整使用指南,快速上手这款工具
🌐 原始信息
原始名称 full-stack-ai-agent-template
原始描述 开源AI工作流:Full-stack AI app generator — FastAPI + Next.js with AI Agents, RAG, streaming, 。⭐1.3k · Python
Topics AI代理模板FastAPINext.js
GitHub https://github.com/vstorm-co/full-stack-ai-agent-template
License MIT
语言 Python
🔗 原始来源
🐙 GitHub 仓库  https://github.com/vstorm-co/full-stack-ai-agent-template 🌐 官方网站  https://vstorm-co.github.io/full-stack-ai-agent-template/

收录时间:2026-05-27 · 更新时间:2026-05-30 · License:MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。