Skip to content

Full-Stack AI Agent Template

Production-Ready AI/LLM Applications — In Minutes, Not Weeks

CI Coverage PyPI Python License

Full-Stack AI Agent Template is a production-ready project generator for AI/LLM applications with 25+ enterprise integrations. Built with FastAPI, Next.js 15, and your choice of AI framework. Install it as the fastapi-fullstack CLI.

Generate complete, type-safe applications with authentication, WebSocket streaming, observability, and deployment configs — all in minutes.

Why this template?

  1. AI-First Design: Native support for PydanticAI, LangChain, LangGraph, DeepAgents with WebSocket streaming and conversation persistence.

  2. Production Ready: 100% test coverage, strict typing, Docker/Kubernetes configs, and battle-tested in real applications.

  3. 25+ Integrations: PostgreSQL, Redis, Celery/Prefect, Logfire, Sentry, Prometheus, Stripe, S3, and more — all optional and configurable.

  4. AI-Agent Friendly: Generated projects include CLAUDE.md and AGENTS.md files optimized for AI coding assistants.

Quick Start

Bash
# 1. Install the generator
uv tool install fastapi-fullstack    # or: pipx install / pip install

# 2. Generate your project (interactive wizard)
fastapi-fullstack

# 3. Backend + PostgreSQL up, migrations applied, admin seeded
cd my_app && make bootstrap

# 4. Frontend (second terminal)
cd frontend && bun install && bun dev

See the Quick Start guide for details and the Installation page for presets and non-interactive flags.

Supported AI Frameworks

Framework Streaming Observability Providers
PydanticAI WebSocket Logfire OpenAI, Anthropic, OpenRouter
LangChain WebSocket LangSmith OpenAI, Anthropic
LangGraph WebSocket LangSmith OpenAI, Anthropic

Core Features

Feature Description
AI Agents PydanticAI, LangChain, LangGraph, DeepAgents with tool calling
WebSocket Streaming Real-time responses with full event access
Authentication JWT + Refresh tokens, API Keys, OAuth2 (Google)
Database PostgreSQL (async, SQLAlchemy 2.0 + Alembic)
Background Tasks Celery, Taskiq, ARQ, or Prefect
Observability Logfire, LangSmith, Sentry, Prometheus
Admin Panel SQLAdmin with authentication
Deployment Docker, Kubernetes, GitHub Actions, GitLab CI

Generated Project Structure

Text Only
my_project/
├── backend/
│   ├── app/
│   │   ├── main.py              # FastAPI app
│   │   ├── api/routes/v1/       # Versioned endpoints
│   │   ├── agents/              # AI agents
│   │   ├── services/            # Business logic
│   │   └── repositories/        # Data access
│   ├── cli/                     # Django-style commands
│   └── tests/
├── frontend/
│   ├── src/
│   │   ├── app/                 # Next.js App Router
│   │   ├── components/          # React components
│   │   └── hooks/               # useChat, useWebSocket
│   └── e2e/                     # Playwright tests
├── docker-compose.yml
└── Makefile

Building advanced AI agents? Check out pydantic-deep - a deep agent framework with planning, filesystem, and subagent capabilities.

Next Steps