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

fastapi-fullstack 0.2.18tar.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 (955) hide show

{fastapi_fullstack-0.2.18 → 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.18
-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
@@ -19,27 +19,26 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Code Generators
 Requires-Python: >=3.11
-Requires-Dist: arq>=0.28.0
-Requires-Dist: celery>=5.6.3
 Requires-Dist: click>=8.3.3
 Requires-Dist: cookiecutter>=2.7.0
 Requires-Dist: email-validator>=2.3.0
-Requires-Dist: httpx>=0.28.1
 Requires-Dist: packaging>=24.0
-Requires-Dist: pydantic-settings>=2.14.2
 Requires-Dist: pydantic>=2.13.0
-Requires-Dist: pytest-asyncio>=1.3.0
-Requires-Dist: pytest>=9.0.3
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: questionary>=2.1.0
 Requires-Dist: rich>=15.0.0
 Requires-Dist: ruff>=0.14.0
-Requires-Dist: stripe>=15.1.0
-Requires-Dist: taskiq>=0.12.4
 Provides-Extra: dev
+Requires-Dist: arq>=0.28.0; extra == 'dev'
+Requires-Dist: celery>=5.6.3; extra == 'dev'
+Requires-Dist: httpx>=0.28.1; extra == 'dev'
 Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
+Requires-Dist: pydantic-settings>=2.14.2; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
 Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
 Requires-Dist: pytest>=9.0.0; extra == 'dev'
+Requires-Dist: stripe>=15.1.0; extra == 'dev'
+Requires-Dist: taskiq>=0.12.4; extra == 'dev'
 Requires-Dist: ty>=0.0.31; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: mkdocs-material>=9.7.0; extra == 'docs'
@@ -47,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">
@@ -58,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>
@@ -81,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>
@@ -122,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
@@ -654,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)
@@ -701,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
@@ -721,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>
@@ -762,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
@@ -776,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)
@@ -802,15 +808,15 @@ 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 |
 | **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 |
+| **Security** | Per-plan sliding-window rate limiting (per user / org / IP), CORS, SSRF-guarded webhook delivery, httpOnly + SameSite session cookies |
 | **Observability** | Logfire, LangSmith, Sentry, Prometheus |
 | **Admin** | SQLAdmin panel with auth |
 | **Collaboration** | Conversation sharing (direct + link), admin conversation browser |
@@ -832,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            │     │
@@ -942,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
@@ -957,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:
@@ -1034,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.
@@ -1089,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.
@@ -1097,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]
@@ -1120,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 |
@@ -1294,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 |
@@ -1315,10 +1323,10 @@ Select what you need:
 ```bash
 fastapi-fullstack new
 # ✓ Redis (caching/sessions)
-# ✓ Rate limiting (slowapi)
+# ✓ 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
@@ -1340,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
@@ -1410,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>
@@ -1422,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 |
@@ -1432,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.18 → 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,15 +760,15 @@ 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 |
 | **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 |
+| **Security** | Per-plan sliding-window rate limiting (per user / org / IP), CORS, SSRF-guarded webhook delivery, httpOnly + SameSite session cookies |
 | **Observability** | Logfire, LangSmith, Sentry, Prometheus |
 | **Admin** | SQLAdmin panel with auth |
 | **Collaboration** | Conversation sharing (direct + link), admin conversation browser |
@@ -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 |
@@ -1266,10 +1275,10 @@ Select what you need:
 ```bash
 fastapi-fullstack new
 # ✓ Redis (caching/sessions)
-# ✓ Rate limiting (slowapi)
+# ✓ 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.18__tar.gz → 0.2.20__tar.gz

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