PyPI - fastapi-fullstack - Versions diffs - 0.2.19__tar.gz → 0.2.20__tar.gz - Mend

fastapi-fullstack 0.2.19tar.gz → 0.2.20tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (950) hide show

{fastapi_fullstack-0.2.19 → fastapi_fullstack-0.2.20}/PKG-INFO RENAMED Viewed

@@ -1,9 +1,9 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: fastapi-fullstack
-Version: 0.2.19
-Summary: Full-stack FastAPI + Next.js template generator with PydanticAI/LangChain agents, WebSocket streaming, 20+ enterprise integrations, and Logfire/LangSmith observability. Ship AI apps fast. CLI tool to generate production-ready FastAPI + Next.js projects with AI agents, auth, and observability.
+Version: 0.2.20
+Summary: Full-stack FastAPI + Next.js template generator with Pydantic AI/LangChain agents, WebSocket streaming, 20+ enterprise integrations, and Logfire/LangSmith observability. Ship AI apps fast.
 Project-URL: Homepage, https://github.com/vstorm-co/full-stack-ai-agent-template
-Project-URL: Documentation, https://github.com/vstorm-co/full-stack-ai-agent-template#readme
+Project-URL: Documentation, https://vstorm-co.github.io/full-stack-ai-agent-template/
 Project-URL: Repository, https://github.com/vstorm-co/full-stack-ai-agent-template
 Author-email: Vstorm <hr@vstorm.co>
 License: MIT
@@ -46,6 +46,13 @@ Requires-Dist: mkdocs>=1.6.1; extra == 'docs'
 Requires-Dist: pymdown-extensions>=10.20; extra == 'docs'
 Description-Content-Type: text/markdown
+<p align="center">
+  <a href="https://github.com/vstorm-co/agenticos">
+    <img src="assets/agenticos-banner-light.png" width="100%" alt="AgenticOS by Vstorm, the Sovereign Agentic AI Layer: AI agents your whole team can use and improve. Open source (Apache-2.0), self-hosted, built on Pydantic AI, with budgets, approvals, guardrails and activity built in. Links to the AgenticOS repository on GitHub.">
+  </a>
+</p>
+<p align="center"><sub>From the team behind this repo: <a href="https://github.com/vstorm-co/agenticos"><b>AgenticOS</b></a>, the Sovereign Agentic AI Layer. AI agents your whole team can use and improve: open source (Apache-2.0), self-hosted, built on Pydantic AI.</sub></p>
 <h1 align="center">Full-Stack AI Agent Template</h1>
 <p align="center">
@@ -57,7 +64,6 @@ Description-Content-Type: text/markdown
   <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>
@@ -80,7 +86,7 @@ Description-Content-Type: text/markdown
 </p>
 <p align="center">
-  <b>🤖 5 AI Agent Frameworks</b> <i>(PydanticAI, PydanticDeep, LangChain, LangGraph, DeepAgents)</i>
+  <b>🤖 5 AI Agent Frameworks</b> <i>(Pydantic AI, Pydantic Deep Agents, LangChain, LangGraph, DeepAgents)</i>
   <br>
   <b>📄 RAG Pipeline</b> <i>(Milvus, Qdrant, pgvector, ChromaDB)</i>
   <br>
@@ -121,22 +127,23 @@ This template is part of a broader open-source ecosystem for production AI agent
 | Project | Description | |
 |---------|-------------|---|
+| **[AgenticOS](https://github.com/vstorm-co/agenticos)** | Open-source (Apache-2.0), self-hosted platform to build, share and govern AI agents across a company. | [![Stars](https://img.shields.io/github/stars/vstorm-co/agenticos?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/agenticos) |
 | **[pydantic-deepagents](https://github.com/vstorm-co/pydantic-deepagents)** | The modular agent runtime for Python. Claude Code-style CLI with Docker sandbox, browser automation, multi-agent teams, and /improve. | [![Stars](https://img.shields.io/github/stars/vstorm-co/pydantic-deepagents?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/pydantic-deepagents) |
 | **[pydantic-ai-shields](https://github.com/vstorm-co/pydantic-ai-shields)** | Drop-in guardrails for Pydantic AI agents. 5 infra + 5 content shields. | [![Stars](https://img.shields.io/github/stars/vstorm-co/pydantic-ai-shields?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/pydantic-ai-shields) |
-| **[pydantic-ai-subagents](https://github.com/vstorm-co/pydantic-ai-subagents)** | Declarative multi-agent orchestration with token tracking. | [![Stars](https://img.shields.io/github/stars/vstorm-co/pydantic-ai-subagents?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/pydantic-ai-subagents) |
-| **[summarization-pydantic-ai](https://github.com/vstorm-co/pydantic-ai-summarization)** | Smart context compression for long-running agents. | [![Stars](https://img.shields.io/github/stars/vstorm-co/summarization-pydantic-ai?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/summarization-pydantic-ai) |
+| **[subagents-pydantic-ai](https://github.com/vstorm-co/subagents-pydantic-ai)** | Declarative multi-agent orchestration with token tracking. | [![Stars](https://img.shields.io/github/stars/vstorm-co/subagents-pydantic-ai?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/subagents-pydantic-ai) |
+| **[summarization-pydantic-ai](https://github.com/vstorm-co/summarization-pydantic-ai)** | Smart context compression for long-running agents. | [![Stars](https://img.shields.io/github/stars/vstorm-co/summarization-pydantic-ai?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/summarization-pydantic-ai) |
 | **[pydantic-ai-backend](https://github.com/vstorm-co/pydantic-ai-backend)** | Sandboxed execution for AI agents. Docker + Daytona. | [![Stars](https://img.shields.io/github/stars/vstorm-co/pydantic-ai-backend?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/pydantic-ai-backend) |
-> **Want the runtime behind this template's AI agents?** [pydantic-deepagents](https://github.com/vstorm-co/pydantic-deepagents) powers the `deepagents` framework option — install it standalone with `curl -fsSL .../install.sh | bash`.
+> **Want the runtime behind this template's AI agents?** [pydantic-deepagents](https://github.com/vstorm-co/pydantic-deepagents) powers the `pydantic_deep` framework option — install it standalone with `curl -fsSL .../install.sh | bash`.
-Browse all projects at [oss.vstorm.co](https://oss.vstorm.co)
+Browse all projects at [github.com/vstorm-co](https://github.com/vstorm-co)
 ---
 ## 🚀 Quick Start
 > [!TIP]
-> **Prefer a visual configurator?** Use the [Web Configurator](https://oss.vstorm.co/projects/full-stack-ai-agent-template/configurator/) to configure your project in the browser and download a ZIP — no CLI installation needed.
+> **Want to review every option first?** The [installation guide](https://vstorm-co.github.io/full-stack-ai-agent-template/installation/) covers the interactive wizard, non-interactive flags and presets; `fastapi-fullstack templates` lists every option.
 ### Installation
@@ -653,7 +660,7 @@ The chat UI streams responses over WebSocket and renders each tool call as a pur
 <tr>
 <td width="50%">
-**Logfire** — distributed tracing: FastAPI, PydanticAI, DB, Redis, Celery, HTTPX in one timeline.
+**Logfire** — distributed tracing: FastAPI, Pydantic AI, DB, Redis, Celery, HTTPX in one timeline.
 ![Logfire](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/logfire.png)
@@ -700,7 +707,7 @@ This template gives you all of that out of the box, with **20+ configurable inte
 ### Perfect For
-- 🤖 **AI Chatbots & Assistants** - PydanticAI or LangChain agents with streaming responses
+- 🤖 **AI Chatbots & Assistants** - Pydantic AI or LangChain agents with streaming responses
 - 📊 **ML Applications** - Background task processing with Celery/Taskiq
 - 🏢 **Enterprise SaaS** - Full auth, admin panel, webhooks, and more
 - 🚀 **Startups** - Ship fast with production-ready infrastructure
@@ -720,7 +727,7 @@ They also ship a ready-to-use **`.claude/` toolkit** that adapts to the options
 ## ✨ 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://ai.pydantic.dev"><img src="https://img.shields.io/badge/Pydantic%20AI-E92063?logo=pydantic&logoColor=white" alt="Pydantic AI"></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>
@@ -761,8 +768,8 @@ They also ship a ready-to-use **`.claude/` toolkit** that adapts to the options
 ### 🤖 AI/LLM First
-- **5 AI Frameworks** - [PydanticAI](https://ai.pydantic.dev), [PydanticDeep](https://github.com/vstorm-co/pydantic-deep), [LangChain](https://python.langchain.com), [LangGraph](https://langchain-ai.github.io/langgraph/), [DeepAgents](https://github.com/vstorm-co/pydantic-deepagents)
-- **4 LLM Providers** - OpenAI, Anthropic, Google Gemini, OpenRouter
+- **5 AI Frameworks** - [Pydantic AI](https://ai.pydantic.dev), [Pydantic Deep Agents](https://github.com/vstorm-co/pydantic-deepagents), [LangChain](https://python.langchain.com), [LangGraph](https://langchain-ai.github.io/langgraph/), [DeepAgents](https://github.com/langchain-ai/deepagents)
+- **5 LLM Providers** - OpenAI, Anthropic, Google Gemini, OpenRouter, and any OpenAI-compatible gateway or server
 - **RAG** - Document ingestion, vector search, reranking (Milvus, Qdrant, ChromaDB, pgvector)
 - **WebSocket Streaming** - Real-time responses with full event access
 - **Rich Chat UI** - Specialized tool-call cards (web search, knowledge base, Python, charts, skills), live subagent feed, citation sources panel, plan/task checklist, reasoning view, and in-chat file previews
@@ -775,7 +782,7 @@ They also ship a ready-to-use **`.claude/` toolkit** that adapts to the options
 - **Multimodal Embeddings** - Provider-aware: OpenAI, Voyage (Anthropic), Gemini (multimodal text + images)
 - **Document Sources** - Local files, API upload, Google Drive, S3/MinIO
 - **Sync Sources** - Per-organization connector management UI (Google Drive, S3/MinIO) with scheduled sync, manual triggers, encrypted credentials, and per-run logs
-- **Observability** - Logfire for PydanticAI, LangSmith for LangChain/LangGraph/DeepAgents
+- **Observability** - Logfire for Pydantic AI, LangSmith for LangChain/LangGraph/DeepAgents
 ### ⚡ Backend (FastAPI)
@@ -801,8 +808,8 @@ They also ship a ready-to-use **`.claude/` toolkit** that adapts to the options
 | Category | Integrations |
 |----------|-------------|
-| **AI Frameworks** | PydanticAI, PydanticDeep, LangChain, LangGraph, DeepAgents |
-| **LLM Providers** | OpenAI, Anthropic, Google Gemini, OpenRouter |
+| **AI Frameworks** | Pydantic AI, Pydantic Deep Agents, LangChain, LangGraph, DeepAgents |
+| **LLM Providers** | OpenAI, Anthropic, Google Gemini, OpenRouter, OpenAI-compatible endpoints |
 | **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 |
@@ -831,7 +838,7 @@ They also ship a ready-to-use **`.claude/` toolkit** that adapts to the options
 │                                                                          │
 │  ┌─────────────────────────────────────────────────────────────────┐     │
 │  │                     AI AGENTS                                   │     │
-│  │  PydanticAI · LangChain · LangGraph · DeepAgents                │     │
+│  │  Pydantic AI · LangChain · LangGraph · DeepAgents               │     │
 │  │  ────────────────────────────────────────────────────────────   │     │
 │  │  Tools: datetime · web_search (Tavily) · search_knowledge_base  │     │
 │  │  Providers: OpenAI · Anthropic · Gemini · OpenRouter            │     │
@@ -941,7 +948,7 @@ See [Architecture Documentation](https://github.com/vstorm-co/full-stack-ai-agen
 Choose from **5 AI frameworks** and **4 LLM providers** when generating your project:
 ```bash
-# PydanticAI with OpenAI (default)
+# Pydantic AI with OpenAI (default)
 fastapi-fullstack create my_app --ai-framework pydantic_ai
 # LangGraph with Anthropic
@@ -956,15 +963,17 @@ fastapi-fullstack create my_app --rag --database postgresql --task-queue celery
 ### Supported Combinations
-| Framework | OpenAI | Anthropic | Gemini | OpenRouter |
-|-----------|:------:|:---------:|:------:|:----------:|
-| **PydanticAI** | ✓ | ✓ | ✓ | ✓ |
-| **PydanticDeep** | ✓ | ✓ | ✓ | - |
-| **LangChain** | ✓ | ✓ | ✓ | - |
-| **LangGraph** | ✓ | ✓ | ✓ | - |
-| **DeepAgents** | ✓ | ✓ | ✓ | - |
+| Framework | OpenAI | Anthropic | Gemini | OpenRouter | OpenAI-compatible |
+|-----------|:------:|:---------:|:------:|:----------:|:-----------------:|
+| **Pydantic AI** | ✓ | ✓ | ✓ | ✓ | ✓ |
+| **Pydantic Deep Agents** | ✓ | ✓ | ✓ | ✓ | ✓ |
+| **LangChain** | ✓ | ✓ | ✓ | - | - |
+| **LangGraph** | ✓ | ✓ | ✓ | - | - |
+| **DeepAgents** | ✓ | ✓ | ✓ | - | - |
+**OpenAI-compatible** (`--llm-provider openai_compatible`) reaches any gateway or server that speaks the OpenAI API by its base URL: model routers and LLM gateways (LiteLLM, Requesty, OrcaRouter, Portkey) and self-hosted servers (vLLM, llama.cpp, LM Studio, Ollama). Set `OPENAI_COMPATIBLE_BASE_URL`, `AI_MODEL` as the endpoint names it, and `OPENAI_COMPATIBLE_API_KEY` if it checks one.
-### PydanticAI Integration
+### Pydantic AI Integration
 Type-safe agents with full dependency injection:
@@ -1033,7 +1042,7 @@ Each framework has its own observability solution:
 | Framework | Observability | Dashboard |
 |-----------|--------------|-----------|
-| **PydanticAI** | [Logfire](https://logfire.pydantic.dev) | Agent runs, tool calls, token usage |
+| **Pydantic AI** | [Logfire](https://logfire.pydantic.dev) | Agent runs, tool calls, token usage |
 | **LangChain** | [LangSmith](https://smith.langchain.com) | Traces, feedback, datasets |
 See [AI Agent Documentation](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/ai-agent.md) for more.
@@ -1088,7 +1097,7 @@ uv run my_app rag-sync-s3 --collection docs --prefix reports/ --bucket my-bucket
 ## 📊 Observability
-### Logfire (for PydanticAI)
+### Logfire (for Pydantic AI)
 [Logfire](https://logfire.pydantic.dev) provides complete observability for your application - from AI agents to database queries. Built by the Pydantic team, it offers first-class support for the entire Python ecosystem.
@@ -1096,7 +1105,7 @@ uv run my_app rag-sync-s3 --collection docs --prefix reports/ --bucket my-bucket
 graph LR
     subgraph Your App
         API[FastAPI]
-        Agent[PydanticAI]
+        Agent[Pydantic AI]
         DB[(Database)]
         Cache[(Redis)]
         Queue[Celery/Taskiq]
@@ -1119,7 +1128,7 @@ graph LR
 | Component | What You See |
 |-----------|-------------|
-| **PydanticAI** | Agent runs, tool calls, LLM requests, token usage, streaming events |
+| **Pydantic AI** | Agent runs, tool calls, LLM requests, token usage, streaming events |
 | **FastAPI** | Request/response traces, latency, status codes, route performance |
 | **PostgreSQL** | Query execution time, slow queries, connection pool stats |
 | **Redis** | Cache hits/misses, command latency, key patterns |
@@ -1293,7 +1302,7 @@ generated_at = "2024-12-21T10:30:00+00:00"
 | **Auth** | `jwt`, `api_key`, `both`, `none` | JWT includes user management |
 | **OAuth** | `none`, `google` | Social login |
 | **AI Framework** | `pydantic_ai`, `pydantic_deep`, `langchain`, `langgraph`, `deepagents` | Choose your AI agent framework |
-| **LLM Provider** | `openai`, `anthropic`, `google`, `openrouter` | OpenRouter only with PydanticAI |
+| **LLM Provider** | `openai`, `anthropic`, `google`, `openrouter`, `openai_compatible`, `all` | OpenRouter and OpenAI-compatible only with Pydantic AI / Pydantic Deep Agents |
 | **RAG** | `--rag` | Enable RAG with vector database |
 | **Vector Store** | `milvus`, `qdrant`, `chromadb`, `pgvector` | pgvector uses existing PostgreSQL |
 | **Background Tasks** | `none`, `celery`, `taskiq`, `arq`, `prefect` | Distributed queues / orchestration |
@@ -1317,7 +1326,7 @@ fastapi-fullstack new
 # ✓ Rate limiting (per user/org/IP, Redis or in-memory)
 # ✓ Pagination (fastapi-pagination)
 # ✓ Admin Panel (SQLAdmin)
-# ✓ AI Agent (PydanticAI or LangChain)
+# ✓ AI Agent (Pydantic AI or LangChain)
 # ✓ Webhooks
 # ✓ Sentry
 # ✓ Logfire / LangSmith
@@ -1339,7 +1348,7 @@ Setting up a production AI agent stack manually means wiring together 10+ tools
 # 2. Configure SQLAlchemy + Alembic migrations
 # 3. Implement JWT auth with refresh tokens
 # 4. Build WebSocket streaming for AI responses
-# 5. Integrate PydanticAI/LangChain with tool calling
+# 5. Integrate Pydantic AI/LangChain with tool calling
 # 6. Set up RAG pipeline (parsing, chunking, embedding, vector store)
 # 7. Configure Celery + Redis for background tasks
 # 8. Build Next.js frontend with auth and chat UI
@@ -1409,7 +1418,7 @@ The generated project is plain code — no lock-in or runtime dependency on the
 <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).
+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 Pydantic AI (which supports all providers natively).
 </details>
@@ -1421,7 +1430,7 @@ Yes. The LLM provider is configured via environment variables (`AI_MODEL`, `OPEN
 |----------|-------------|
 | [Architecture](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/architecture.md) | Repository + Service pattern, layered design |
 | [Frontend](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/frontend.md) | Next.js setup, auth, state management |
-| [AI Agent](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/ai-agent.md) | PydanticAI, tools, WebSocket streaming |
+| [AI Agent](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/ai-agent.md) | Pydantic AI, tools, WebSocket streaming |
 | [Observability](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/observability.md) | Logfire integration, tracing, metrics |
 | [Deployment](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/deployment.md) | Docker, Kubernetes, production setup |
 | [Development](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/development.md) | Local setup, testing, debugging |
@@ -1431,7 +1440,7 @@ Yes. The LLM provider is configured via environment variables (`AI_MODEL`, `OPEN
 ## Star History
-[![Star History Chart](https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=date&legend=top-left)](https://www.star-history.com/#vstorm-co/full-stack-fastapi-nextjs-llm-template&type=date&legend=top-left)
+[![Star History Chart](https://api.star-history.com/svg?repos=vstorm-co/full-stack-ai-agent-template&type=date&legend=top-left)](https://www.star-history.com/#vstorm-co/full-stack-ai-agent-template&type=date&legend=top-left)
 ---

{fastapi_fullstack-0.2.19 → fastapi_fullstack-0.2.20}/README.md RENAMED Viewed

@@ -1,3 +1,10 @@
+<p align="center">
+  <a href="https://github.com/vstorm-co/agenticos">
+    <img src="assets/agenticos-banner-light.png" width="100%" alt="AgenticOS by Vstorm, the Sovereign Agentic AI Layer: AI agents your whole team can use and improve. Open source (Apache-2.0), self-hosted, built on Pydantic AI, with budgets, approvals, guardrails and activity built in. Links to the AgenticOS repository on GitHub.">
+  </a>
+</p>
+<p align="center"><sub>From the team behind this repo: <a href="https://github.com/vstorm-co/agenticos"><b>AgenticOS</b></a>, the Sovereign Agentic AI Layer. AI agents your whole team can use and improve: open source (Apache-2.0), self-hosted, built on Pydantic AI.</sub></p>
 <h1 align="center">Full-Stack AI Agent Template</h1>
 <p align="center">
@@ -9,7 +16,6 @@
   <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>
@@ -32,7 +38,7 @@
 </p>
 <p align="center">
-  <b>🤖 5 AI Agent Frameworks</b> <i>(PydanticAI, PydanticDeep, LangChain, LangGraph, DeepAgents)</i>
+  <b>🤖 5 AI Agent Frameworks</b> <i>(Pydantic AI, Pydantic Deep Agents, LangChain, LangGraph, DeepAgents)</i>
   <br>
   <b>📄 RAG Pipeline</b> <i>(Milvus, Qdrant, pgvector, ChromaDB)</i>
   <br>
@@ -73,22 +79,23 @@ This template is part of a broader open-source ecosystem for production AI agent
 | Project | Description | |
 |---------|-------------|---|
+| **[AgenticOS](https://github.com/vstorm-co/agenticos)** | Open-source (Apache-2.0), self-hosted platform to build, share and govern AI agents across a company. | [![Stars](https://img.shields.io/github/stars/vstorm-co/agenticos?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/agenticos) |
 | **[pydantic-deepagents](https://github.com/vstorm-co/pydantic-deepagents)** | The modular agent runtime for Python. Claude Code-style CLI with Docker sandbox, browser automation, multi-agent teams, and /improve. | [![Stars](https://img.shields.io/github/stars/vstorm-co/pydantic-deepagents?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/pydantic-deepagents) |
 | **[pydantic-ai-shields](https://github.com/vstorm-co/pydantic-ai-shields)** | Drop-in guardrails for Pydantic AI agents. 5 infra + 5 content shields. | [![Stars](https://img.shields.io/github/stars/vstorm-co/pydantic-ai-shields?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/pydantic-ai-shields) |
-| **[pydantic-ai-subagents](https://github.com/vstorm-co/pydantic-ai-subagents)** | Declarative multi-agent orchestration with token tracking. | [![Stars](https://img.shields.io/github/stars/vstorm-co/pydantic-ai-subagents?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/pydantic-ai-subagents) |
-| **[summarization-pydantic-ai](https://github.com/vstorm-co/pydantic-ai-summarization)** | Smart context compression for long-running agents. | [![Stars](https://img.shields.io/github/stars/vstorm-co/summarization-pydantic-ai?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/summarization-pydantic-ai) |
+| **[subagents-pydantic-ai](https://github.com/vstorm-co/subagents-pydantic-ai)** | Declarative multi-agent orchestration with token tracking. | [![Stars](https://img.shields.io/github/stars/vstorm-co/subagents-pydantic-ai?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/subagents-pydantic-ai) |
+| **[summarization-pydantic-ai](https://github.com/vstorm-co/summarization-pydantic-ai)** | Smart context compression for long-running agents. | [![Stars](https://img.shields.io/github/stars/vstorm-co/summarization-pydantic-ai?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/summarization-pydantic-ai) |
 | **[pydantic-ai-backend](https://github.com/vstorm-co/pydantic-ai-backend)** | Sandboxed execution for AI agents. Docker + Daytona. | [![Stars](https://img.shields.io/github/stars/vstorm-co/pydantic-ai-backend?style=flat&logo=github&color=yellow)](https://github.com/vstorm-co/pydantic-ai-backend) |
-> **Want the runtime behind this template's AI agents?** [pydantic-deepagents](https://github.com/vstorm-co/pydantic-deepagents) powers the `deepagents` framework option — install it standalone with `curl -fsSL .../install.sh | bash`.
+> **Want the runtime behind this template's AI agents?** [pydantic-deepagents](https://github.com/vstorm-co/pydantic-deepagents) powers the `pydantic_deep` framework option — install it standalone with `curl -fsSL .../install.sh | bash`.
-Browse all projects at [oss.vstorm.co](https://oss.vstorm.co)
+Browse all projects at [github.com/vstorm-co](https://github.com/vstorm-co)
 ---
 ## 🚀 Quick Start
 > [!TIP]
-> **Prefer a visual configurator?** Use the [Web Configurator](https://oss.vstorm.co/projects/full-stack-ai-agent-template/configurator/) to configure your project in the browser and download a ZIP — no CLI installation needed.
+> **Want to review every option first?** The [installation guide](https://vstorm-co.github.io/full-stack-ai-agent-template/installation/) covers the interactive wizard, non-interactive flags and presets; `fastapi-fullstack templates` lists every option.
 ### Installation
@@ -605,7 +612,7 @@ The chat UI streams responses over WebSocket and renders each tool call as a pur
 <tr>
 <td width="50%">
-**Logfire** — distributed tracing: FastAPI, PydanticAI, DB, Redis, Celery, HTTPX in one timeline.
+**Logfire** — distributed tracing: FastAPI, Pydantic AI, DB, Redis, Celery, HTTPX in one timeline.
 ![Logfire](https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/logfire.png)
@@ -652,7 +659,7 @@ This template gives you all of that out of the box, with **20+ configurable inte
 ### Perfect For
-- 🤖 **AI Chatbots & Assistants** - PydanticAI or LangChain agents with streaming responses
+- 🤖 **AI Chatbots & Assistants** - Pydantic AI or LangChain agents with streaming responses
 - 📊 **ML Applications** - Background task processing with Celery/Taskiq
 - 🏢 **Enterprise SaaS** - Full auth, admin panel, webhooks, and more
 - 🚀 **Startups** - Ship fast with production-ready infrastructure
@@ -672,7 +679,7 @@ They also ship a ready-to-use **`.claude/` toolkit** that adapts to the options
 ## ✨ 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://ai.pydantic.dev"><img src="https://img.shields.io/badge/Pydantic%20AI-E92063?logo=pydantic&logoColor=white" alt="Pydantic AI"></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>
@@ -713,8 +720,8 @@ They also ship a ready-to-use **`.claude/` toolkit** that adapts to the options
 ### 🤖 AI/LLM First
-- **5 AI Frameworks** - [PydanticAI](https://ai.pydantic.dev), [PydanticDeep](https://github.com/vstorm-co/pydantic-deep), [LangChain](https://python.langchain.com), [LangGraph](https://langchain-ai.github.io/langgraph/), [DeepAgents](https://github.com/vstorm-co/pydantic-deepagents)
-- **4 LLM Providers** - OpenAI, Anthropic, Google Gemini, OpenRouter
+- **5 AI Frameworks** - [Pydantic AI](https://ai.pydantic.dev), [Pydantic Deep Agents](https://github.com/vstorm-co/pydantic-deepagents), [LangChain](https://python.langchain.com), [LangGraph](https://langchain-ai.github.io/langgraph/), [DeepAgents](https://github.com/langchain-ai/deepagents)
+- **5 LLM Providers** - OpenAI, Anthropic, Google Gemini, OpenRouter, and any OpenAI-compatible gateway or server
 - **RAG** - Document ingestion, vector search, reranking (Milvus, Qdrant, ChromaDB, pgvector)
 - **WebSocket Streaming** - Real-time responses with full event access
 - **Rich Chat UI** - Specialized tool-call cards (web search, knowledge base, Python, charts, skills), live subagent feed, citation sources panel, plan/task checklist, reasoning view, and in-chat file previews
@@ -727,7 +734,7 @@ They also ship a ready-to-use **`.claude/` toolkit** that adapts to the options
 - **Multimodal Embeddings** - Provider-aware: OpenAI, Voyage (Anthropic), Gemini (multimodal text + images)
 - **Document Sources** - Local files, API upload, Google Drive, S3/MinIO
 - **Sync Sources** - Per-organization connector management UI (Google Drive, S3/MinIO) with scheduled sync, manual triggers, encrypted credentials, and per-run logs
-- **Observability** - Logfire for PydanticAI, LangSmith for LangChain/LangGraph/DeepAgents
+- **Observability** - Logfire for Pydantic AI, LangSmith for LangChain/LangGraph/DeepAgents
 ### ⚡ Backend (FastAPI)
@@ -753,8 +760,8 @@ They also ship a ready-to-use **`.claude/` toolkit** that adapts to the options
 | Category | Integrations |
 |----------|-------------|
-| **AI Frameworks** | PydanticAI, PydanticDeep, LangChain, LangGraph, DeepAgents |
-| **LLM Providers** | OpenAI, Anthropic, Google Gemini, OpenRouter |
+| **AI Frameworks** | Pydantic AI, Pydantic Deep Agents, LangChain, LangGraph, DeepAgents |
+| **LLM Providers** | OpenAI, Anthropic, Google Gemini, OpenRouter, OpenAI-compatible endpoints |
 | **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 |
@@ -783,7 +790,7 @@ They also ship a ready-to-use **`.claude/` toolkit** that adapts to the options
 │                                                                          │
 │  ┌─────────────────────────────────────────────────────────────────┐     │
 │  │                     AI AGENTS                                   │     │
-│  │  PydanticAI · LangChain · LangGraph · DeepAgents                │     │
+│  │  Pydantic AI · LangChain · LangGraph · DeepAgents               │     │
 │  │  ────────────────────────────────────────────────────────────   │     │
 │  │  Tools: datetime · web_search (Tavily) · search_knowledge_base  │     │
 │  │  Providers: OpenAI · Anthropic · Gemini · OpenRouter            │     │
@@ -893,7 +900,7 @@ See [Architecture Documentation](https://github.com/vstorm-co/full-stack-ai-agen
 Choose from **5 AI frameworks** and **4 LLM providers** when generating your project:
 ```bash
-# PydanticAI with OpenAI (default)
+# Pydantic AI with OpenAI (default)
 fastapi-fullstack create my_app --ai-framework pydantic_ai
 # LangGraph with Anthropic
@@ -908,15 +915,17 @@ fastapi-fullstack create my_app --rag --database postgresql --task-queue celery
 ### Supported Combinations
-| Framework | OpenAI | Anthropic | Gemini | OpenRouter |
-|-----------|:------:|:---------:|:------:|:----------:|
-| **PydanticAI** | ✓ | ✓ | ✓ | ✓ |
-| **PydanticDeep** | ✓ | ✓ | ✓ | - |
-| **LangChain** | ✓ | ✓ | ✓ | - |
-| **LangGraph** | ✓ | ✓ | ✓ | - |
-| **DeepAgents** | ✓ | ✓ | ✓ | - |
+| Framework | OpenAI | Anthropic | Gemini | OpenRouter | OpenAI-compatible |
+|-----------|:------:|:---------:|:------:|:----------:|:-----------------:|
+| **Pydantic AI** | ✓ | ✓ | ✓ | ✓ | ✓ |
+| **Pydantic Deep Agents** | ✓ | ✓ | ✓ | ✓ | ✓ |
+| **LangChain** | ✓ | ✓ | ✓ | - | - |
+| **LangGraph** | ✓ | ✓ | ✓ | - | - |
+| **DeepAgents** | ✓ | ✓ | ✓ | - | - |
+**OpenAI-compatible** (`--llm-provider openai_compatible`) reaches any gateway or server that speaks the OpenAI API by its base URL: model routers and LLM gateways (LiteLLM, Requesty, OrcaRouter, Portkey) and self-hosted servers (vLLM, llama.cpp, LM Studio, Ollama). Set `OPENAI_COMPATIBLE_BASE_URL`, `AI_MODEL` as the endpoint names it, and `OPENAI_COMPATIBLE_API_KEY` if it checks one.
-### PydanticAI Integration
+### Pydantic AI Integration
 Type-safe agents with full dependency injection:
@@ -985,7 +994,7 @@ Each framework has its own observability solution:
 | Framework | Observability | Dashboard |
 |-----------|--------------|-----------|
-| **PydanticAI** | [Logfire](https://logfire.pydantic.dev) | Agent runs, tool calls, token usage |
+| **Pydantic AI** | [Logfire](https://logfire.pydantic.dev) | Agent runs, tool calls, token usage |
 | **LangChain** | [LangSmith](https://smith.langchain.com) | Traces, feedback, datasets |
 See [AI Agent Documentation](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/ai-agent.md) for more.
@@ -1040,7 +1049,7 @@ uv run my_app rag-sync-s3 --collection docs --prefix reports/ --bucket my-bucket
 ## 📊 Observability
-### Logfire (for PydanticAI)
+### Logfire (for Pydantic AI)
 [Logfire](https://logfire.pydantic.dev) provides complete observability for your application - from AI agents to database queries. Built by the Pydantic team, it offers first-class support for the entire Python ecosystem.
@@ -1048,7 +1057,7 @@ uv run my_app rag-sync-s3 --collection docs --prefix reports/ --bucket my-bucket
 graph LR
     subgraph Your App
         API[FastAPI]
-        Agent[PydanticAI]
+        Agent[Pydantic AI]
         DB[(Database)]
         Cache[(Redis)]
         Queue[Celery/Taskiq]
@@ -1071,7 +1080,7 @@ graph LR
 | Component | What You See |
 |-----------|-------------|
-| **PydanticAI** | Agent runs, tool calls, LLM requests, token usage, streaming events |
+| **Pydantic AI** | Agent runs, tool calls, LLM requests, token usage, streaming events |
 | **FastAPI** | Request/response traces, latency, status codes, route performance |
 | **PostgreSQL** | Query execution time, slow queries, connection pool stats |
 | **Redis** | Cache hits/misses, command latency, key patterns |
@@ -1245,7 +1254,7 @@ generated_at = "2024-12-21T10:30:00+00:00"
 | **Auth** | `jwt`, `api_key`, `both`, `none` | JWT includes user management |
 | **OAuth** | `none`, `google` | Social login |
 | **AI Framework** | `pydantic_ai`, `pydantic_deep`, `langchain`, `langgraph`, `deepagents` | Choose your AI agent framework |
-| **LLM Provider** | `openai`, `anthropic`, `google`, `openrouter` | OpenRouter only with PydanticAI |
+| **LLM Provider** | `openai`, `anthropic`, `google`, `openrouter`, `openai_compatible`, `all` | OpenRouter and OpenAI-compatible only with Pydantic AI / Pydantic Deep Agents |
 | **RAG** | `--rag` | Enable RAG with vector database |
 | **Vector Store** | `milvus`, `qdrant`, `chromadb`, `pgvector` | pgvector uses existing PostgreSQL |
 | **Background Tasks** | `none`, `celery`, `taskiq`, `arq`, `prefect` | Distributed queues / orchestration |
@@ -1269,7 +1278,7 @@ fastapi-fullstack new
 # ✓ Rate limiting (per user/org/IP, Redis or in-memory)
 # ✓ Pagination (fastapi-pagination)
 # ✓ Admin Panel (SQLAdmin)
-# ✓ AI Agent (PydanticAI or LangChain)
+# ✓ AI Agent (Pydantic AI or LangChain)
 # ✓ Webhooks
 # ✓ Sentry
 # ✓ Logfire / LangSmith
@@ -1291,7 +1300,7 @@ Setting up a production AI agent stack manually means wiring together 10+ tools
 # 2. Configure SQLAlchemy + Alembic migrations
 # 3. Implement JWT auth with refresh tokens
 # 4. Build WebSocket streaming for AI responses
-# 5. Integrate PydanticAI/LangChain with tool calling
+# 5. Integrate Pydantic AI/LangChain with tool calling
 # 6. Set up RAG pipeline (parsing, chunking, embedding, vector store)
 # 7. Configure Celery + Redis for background tasks
 # 8. Build Next.js frontend with auth and chat UI
@@ -1361,7 +1370,7 @@ The generated project is plain code — no lock-in or runtime dependency on the
 <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).
+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 Pydantic AI (which supports all providers natively).
 </details>
@@ -1373,7 +1382,7 @@ Yes. The LLM provider is configured via environment variables (`AI_MODEL`, `OPEN
 |----------|-------------|
 | [Architecture](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/architecture.md) | Repository + Service pattern, layered design |
 | [Frontend](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/frontend.md) | Next.js setup, auth, state management |
-| [AI Agent](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/ai-agent.md) | PydanticAI, tools, WebSocket streaming |
+| [AI Agent](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/ai-agent.md) | Pydantic AI, tools, WebSocket streaming |
 | [Observability](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/observability.md) | Logfire integration, tracing, metrics |
 | [Deployment](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/deployment.md) | Docker, Kubernetes, production setup |
 | [Development](https://github.com/vstorm-co/full-stack-ai-agent-template/blob/main/docs/development.md) | Local setup, testing, debugging |
@@ -1383,7 +1392,7 @@ Yes. The LLM provider is configured via environment variables (`AI_MODEL`, `OPEN
 ## Star History
-[![Star History Chart](https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=date&legend=top-left)](https://www.star-history.com/#vstorm-co/full-stack-fastapi-nextjs-llm-template&type=date&legend=top-left)
+[![Star History Chart](https://api.star-history.com/svg?repos=vstorm-co/full-stack-ai-agent-template&type=date&legend=top-left)](https://www.star-history.com/#vstorm-co/full-stack-ai-agent-template&type=date&legend=top-left)
 ---

{fastapi_fullstack-0.2.19 → fastapi_fullstack-0.2.20}/UPGRADES.yaml RENAMED Viewed

@@ -18,6 +18,19 @@
 #   manual_steps:
 #     - "Run `alembic upgrade head` (new billing tables)."
+- version: "0.2.20"
+  breaking:
+    - "Redis is replaced by Valkey (valkey/valkey:9-alpine) in the compose files and the generated CI. The protocol, the redis client, the REDIS_* settings and the `redis` service name are unchanged."
+    - "DATABASE_URL_SYNC now names its driver (postgresql+psycopg2://). Code that passed it to asyncpg must strip the driver first, as app/db/todo_pool.py does."
+    - "Pydantic AI 2.x is the floor (pydantic-ai-slim>=2.0.0). Custom code reading FunctionToolResultEvent.result must read .part instead; .result no longer exists."
+    - "PydanticDeep projects run on pydantic-deep 0.3.50 and Pydantic AI workspaces: PydanticDeepAssistant takes no backend_override, write_file_to_workspace is now upload_file(filename, content), and the Daytona backend is DaytonaWorkspace (the `daytona` extra of pydantic-ai-backend)."
+    - "MCP client projects need mcp>=2.0.0: the streamable-HTTP client is streamable_http_client, and app/agents/mcp_oauth.py uses httpx2."
+    - "Slack multi-person DMs (mpim) are now chat_type \"group\", not \"private\"."
+  manual_steps:
+    - "Before the first start on Valkey: move /data/dump.rdb out of the redis_data volume (or recreate the volume). Valkey cannot load an RDB written by Redis 7.4 (`Can't handle RDB format version 12`); the template keeps only cache, broker and rate-limit data there."
+    - "Run `uv sync` in backend/: several floors moved (pydantic-ai-slim 2.0, pydantic-monty 1.0, pydantic-ai-skills 2.0, mcp 2.0, pydantic-deep 0.3.50), and OpenAI embeddings now declare `openai` themselves."
+    - "Skills: drop-in SKILL.md files keep working; the agent now loads each one with `load_capability` instead of `load_skill`."
 - version: "0.2.19"
   removed:
     - "backend/app/core/rate_limit.py"

{fastapi_fullstack-0.2.19 → fastapi_fullstack-0.2.20}/fastapi_gen/cli.py RENAMED Viewed

@@ -395,11 +395,13 @@ def new(output: Path | None, no_input: bool, name: str | None, minimal: bool) ->
 )
 @click.option(
     "--llm-provider",
-    type=click.Choice(["openai", "anthropic", "google", "openrouter", "all"]),
+    type=click.Choice(["openai", "anthropic", "google", "openrouter", "openai_compatible", "all"]),
     default="openai",
     help=(
         "LLM provider (default: openai). 'all' installs every SDK and lets users "
-        "pick the model at runtime. openrouter requires pydantic_ai."
+        "pick the model at runtime. openai_compatible targets any OpenAI-compatible "
+        "gateway or server by base URL. openrouter and openai_compatible require "
+        "pydantic_ai or pydantic_deep."
     ),
 )
 @click.option("--redis", is_flag=True, help="Enable Redis")
@@ -498,6 +500,12 @@ def new(output: Path | None, no_input: bool, name: str | None, minimal: bool) ->
     default=False,
     help="Enable the MCP client — connect external MCP servers as agent tools (PydanticAI only)",
 )
+@click.option(
+    "--memory",
+    is_flag=True,
+    default=False,
+    help="Enable persistent per-user agent memory (Settings → Memory, Pydantic AI + PostgreSQL only)",
+)
 @click.option("--session-management", is_flag=True, help="Enable session management")
 @click.option(
     "--reverse-proxy",
@@ -783,6 +791,7 @@ def create(
     skills: bool,
     deep_research: bool,
     mcp_client: bool,
+    memory: bool,
     session_management: bool,
     reverse_proxy: str,
     kubernetes: bool,
@@ -1205,6 +1214,7 @@ def create(
                 enable_skills=skills,
                 enable_deep_research=deep_research,
                 enable_mcp_client=mcp_client,
+                enable_memory=memory,
                 enable_session_management=session_management,
                 reverse_proxy=_rp_map[reverse_proxy],
                 enable_kubernetes=kubernetes,
@@ -1362,6 +1372,9 @@ def templates() -> None:
     console.print("  --llm-provider anthropic        Anthropic (claude-opus-4-7)")
     console.print("  --llm-provider google           Google Gemini (gemini-2.5-flash)")
     console.print("  --llm-provider openrouter       OpenRouter (pydantic_ai only)")
+    console.print(
+        "  --llm-provider openai_compatible  Any OpenAI-compatible gateway or server (pydantic_ai only)"
+    )
     console.print(
         "  --websockets                    Enable WebSocket support (real-time chat streaming)"
     )

fastapi-fullstack 0.2.19__tar.gz → 0.2.20__tar.gz

fastapi-fullstack 0.2.19tar.gz → 0.2.20tar.gz