fastapi-fullstack 0.2.8__tar.gz → 0.2.9__tar.gz

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-fullstack
-Version: 0.2.8
+Version: 0.2.9
 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.
 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
@@ -221,7 +221,7 @@ make dev-frontend  # start the Next.js container
 |---|---|---|
 | `make dev` | `docker-compose.dev.yml` | Local development with hot-reload + bind-mounted source. |
 | `make stage` | `docker-compose.yml` | Production-like build (no bind mounts) running on localhost. Sanity-check before deploy. |
-| `make prod` | `docker-compose.prod.yml` | Production. Requires `.env.prod` (copy from `.env.prod.example`) + external Nginx using `nginx/nginx.conf`. |
+| `make prod` | `docker-compose.prod.yml` | Production. 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.
 
@@ -255,7 +255,7 @@ make run                                                    # uvicorn --reload
 git clone <your-repo>
 cd my_ai_app
 
-cp .env.prod.example .env.prod                  # fill in real secrets
+cp backend/.env.example backend/.env            # fill in real secrets
 # Configure your nginx host using nginx/nginx.conf as reference
 
 make prod                                       # builds + starts + migrates
@@ -298,10 +298,16 @@ Use `make help` to see all available Makefile shortcuts.
   <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/app_start.gif" alt="FastAPI Fullstack Generator Demo">
 </p>
 
-**Live chat:**
+**Live chat — web search:**
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/chat_demo_light.gif" alt="Chat Demo">
+  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/chat/websearchdemo.gif" alt="Agent answering with live web search">
+</p>
+
+**Live chat — chart generation:**
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/chat/chartdemo.gif" alt="Agent generating an interactive chart">
 </p>
 
 **File upload & RAG ingestion:**

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/README.md

@@ -174,7 +174,7 @@ make dev-frontend  # start the Next.js container
 |---|---|---|
 | `make dev` | `docker-compose.dev.yml` | Local development with hot-reload + bind-mounted source. |
 | `make stage` | `docker-compose.yml` | Production-like build (no bind mounts) running on localhost. Sanity-check before deploy. |
-| `make prod` | `docker-compose.prod.yml` | Production. Requires `.env.prod` (copy from `.env.prod.example`) + external Nginx using `nginx/nginx.conf`. |
+| `make prod` | `docker-compose.prod.yml` | Production. 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.
 
@@ -208,7 +208,7 @@ make run                                                    # uvicorn --reload
 git clone <your-repo>
 cd my_ai_app
 
-cp .env.prod.example .env.prod                  # fill in real secrets
+cp backend/.env.example backend/.env            # fill in real secrets
 # Configure your nginx host using nginx/nginx.conf as reference
 
 make prod                                       # builds + starts + migrates
@@ -251,10 +251,16 @@ Use `make help` to see all available Makefile shortcuts.
   <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/app_start.gif" alt="FastAPI Fullstack Generator Demo">
 </p>
 
-**Live chat:**
+**Live chat — web search:**
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/new/chat_demo_light.gif" alt="Chat Demo">
+  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/chat/websearchdemo.gif" alt="Agent answering with live web search">
+</p>
+
+**Live chat — chart generation:**
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-ai-agent-template/main/assets/chat/chartdemo.gif" alt="Agent generating an interactive chart">
 </p>
 
 **File upload & RAG ingestion:**

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/fastapi_gen/cli.py

@@ -465,6 +465,12 @@ def new(output: Path | None, no_input: bool, name: str | None, minimal: bool) ->
 @click.option(
     "--web-fetch", is_flag=True, default=False, help="Enable web fetch/scraping tool for AI agents"
 )
+@click.option(
+    "--charts",
+    is_flag=True,
+    default=False,
+    help="Enable the chart-generation tool for AI agents (line/bar/pie/area/scatter)",
+)
 @click.option("--session-management", is_flag=True, help="Enable session management")
 @click.option(
     "--reverse-proxy",
@@ -739,6 +745,7 @@ def create(
     websockets: bool,
     web_search: bool,
     web_fetch: bool,
+    charts: bool,
     session_management: bool,
     reverse_proxy: str,
     kubernetes: bool,
@@ -1166,6 +1173,7 @@ def create(
                 enable_websockets=websockets,
                 enable_web_search=web_search,
                 enable_web_fetch=web_fetch,
+                enable_charts=charts,
                 enable_session_management=session_management,
                 reverse_proxy=_rp_map[reverse_proxy],
                 enable_kubernetes=kubernetes,
@@ -1321,9 +1329,9 @@ def templates() -> None:
     console.print(
         "  --ai-framework pydantic_deep    PydanticDeep (deep agentic coding, Docker sandbox)"
     )
-    console.print("  --llm-provider openai           OpenAI (gpt-4o-mini)")
-    console.print("  --llm-provider anthropic        Anthropic (claude-sonnet-4-5)")
-    console.print("  --llm-provider google           Google Gemini (gemini-2.0-flash)")
+    console.print("  --llm-provider openai           OpenAI (gpt-5.5)")
+    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(
         "  --websockets                    Enable WebSocket support (real-time chat streaming)"

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/fastapi_gen/config.py

@@ -324,6 +324,7 @@ class ProjectConfig(BaseModel):
     enable_langsmith: bool = False
     enable_web_search: bool = False
     enable_web_fetch: bool = False
+    enable_charts: bool = False
     use_telegram: bool = False
     use_slack: bool = False
     enable_cors: bool = True
@@ -791,6 +792,18 @@ class ProjectConfig(BaseModel):
             "enable_langsmith": self.enable_langsmith,
             "enable_web_search": self.enable_web_search,
             "enable_web_fetch": self.enable_web_fetch,
+            # PydanticAI/PydanticDeep have a model-native WebFetch capability;
+            # the other frameworks don't, so they get a portable fetch_url tool.
+            "web_fetch_tool": self.enable_web_fetch
+            and self.ai_framework
+            in (
+                AIFrameworkType.LANGCHAIN,
+                AIFrameworkType.LANGGRAPH,
+                AIFrameworkType.CREWAI,
+                AIFrameworkType.DEEPAGENTS,
+            ),
+            "enable_charts": self.enable_charts,
+            "charts_channel_png": self.enable_charts and (self.use_slack or self.use_telegram),
             "enable_webhooks": self.enable_webhooks,
             # Legacy fixed values (WebSocket always uses JWT)
             "websocket_auth": "jwt",

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/fastapi_gen/prompts.py

@@ -800,9 +800,9 @@ def prompt_llm_provider(ai_framework: AIFrameworkType) -> LLMProviderType:
     console.print()
 
     choices = [
-        questionary.Choice("OpenAI (gpt-4o-mini)", value=LLMProviderType.OPENAI),
-        questionary.Choice("Anthropic (claude-sonnet-4-5)", value=LLMProviderType.ANTHROPIC),
-        questionary.Choice("Google Gemini (gemini-2.0-flash)", value=LLMProviderType.GOOGLE),
+        questionary.Choice("OpenAI (gpt-5.5)", value=LLMProviderType.OPENAI),
+        questionary.Choice("Anthropic (claude-opus-4-7)", value=LLMProviderType.ANTHROPIC),
+        questionary.Choice("Google Gemini (gemini-2.5-flash)", value=LLMProviderType.GOOGLE),
     ]
 
     # OpenRouter available for PydanticAI and PydanticDeep (both use pydantic-ai)
@@ -823,36 +823,77 @@ def prompt_llm_provider(ai_framework: AIFrameworkType) -> LLMProviderType:
     )
 
 
-def prompt_pydantic_capabilities() -> tuple[bool, bool]:
-    """Prompt for PydanticAI built-in capabilities (WebSearch, WebFetch).
+def prompt_web_capabilities(ai_framework: AIFrameworkType) -> tuple[bool, bool]:
+    """Prompt for web search / web fetch.
+
+    PydanticAI and PydanticDeep use the model-native WebSearch/WebFetch
+    capabilities. LangChain, LangGraph, CrewAI and DeepAgents use a
+    Tavily-backed web search tool plus a portable fetch_url tool.
 
     Returns:
         Tuple of (enable_web_search, enable_web_fetch).
     """
+    native = ai_framework in (
+        AIFrameworkType.PYDANTIC_AI,
+        AIFrameworkType.PYDANTIC_DEEP,
+    )
+
     console.print()
-    console.print("[bold cyan]PydanticAI Capabilities[/]")
-    console.print("Built-in model capabilities (model must support them).")
+    console.print("[bold cyan]Web Search & Fetch[/]")
+    if native:
+        console.print("Built-in model capabilities (the model must support them).")
+    else:
+        console.print(
+            "Web search uses Tavily (needs TAVILY_API_KEY); "
+            "fetch reads a given URL's readable content."
+        )
     console.print()
 
+    search_q = (
+        "Enable WebSearch capability (model-native web search)?"
+        if native
+        else "Enable the web search tool (Tavily — needs TAVILY_API_KEY)?"
+    )
+    fetch_q = (
+        "Enable WebFetch capability (model-native URL fetching)?"
+        if native
+        else "Enable the fetch-URL tool (read a web page's content)?"
+    )
+
     enable_web_search = cast(
         bool,
-        _check_cancelled(
-            questionary.confirm(
-                "Enable WebSearch capability (model-native web search)?",
-                default=False,
-            ).ask()
-        ),
+        _check_cancelled(questionary.confirm(search_q, default=False).ask()),
     )
     enable_web_fetch = cast(
+        bool,
+        _check_cancelled(questionary.confirm(fetch_q, default=False).ask()),
+    )
+    return enable_web_search, enable_web_fetch
+
+
+def prompt_charts() -> bool:
+    """Prompt for the agent chart-generation tool.
+
+    Returns:
+        Whether the chart tool is enabled.
+    """
+    console.print()
+    console.print("[bold cyan]Chart Generation Tool[/]")
+    console.print(
+        "Lets the agent produce line/bar/pie/area/scatter charts. Rendered "
+        "interactively in the web chat; sent as PNG images on Slack/Telegram."
+    )
+    console.print()
+
+    return cast(
         bool,
         _check_cancelled(
             questionary.confirm(
-                "Enable WebFetch capability (model-native URL fetching)?",
+                "Enable the chart-generation tool for the agent?",
                 default=False,
             ).ask()
         ),
     )
-    return enable_web_search, enable_web_fetch
 
 
 def prompt_langsmith() -> bool:
@@ -1363,6 +1404,7 @@ def run_interactive_prompts() -> ProjectConfig:
         "enable_langsmith": False,
         "enable_web_search": False,
         "enable_web_fetch": False,
+        "enable_charts": False,
         "rag_features": RAGFeatures(),
         "orm_type": OrmType.SQLALCHEMY,
         "sandbox_backend": "state",
@@ -1486,15 +1528,15 @@ def run_interactive_prompts() -> ProjectConfig:
         else:
             state["llm_provider"] = prompt_llm_provider(state["ai_framework"])
 
-    def step_pydantic_capabilities() -> None:
-        if state["ai_framework"] == AIFrameworkType.PYDANTIC_AI:
+    def step_web_capabilities() -> None:
+        if state["ai_framework"] == AIFrameworkType.NONE:
+            state["enable_web_search"] = False
+            state["enable_web_fetch"] = False
+        else:
             (
                 state["enable_web_search"],
                 state["enable_web_fetch"],
-            ) = prompt_pydantic_capabilities()
-        else:
-            state["enable_web_search"] = False
-            state["enable_web_fetch"] = False
+            ) = prompt_web_capabilities(state["ai_framework"])
 
     def step_rag_config() -> None:
         if state["ai_framework"] == AIFrameworkType.NONE:
@@ -1515,6 +1557,12 @@ def run_interactive_prompts() -> ProjectConfig:
                 )
                 state["dev_tools"]["enable_docker"] = True
 
+    def step_charts() -> None:
+        if state["ai_framework"] == AIFrameworkType.NONE:
+            state["enable_charts"] = False
+        else:
+            state["enable_charts"] = prompt_charts()
+
     def step_langsmith() -> None:
         if state["ai_framework"] in (
             AIFrameworkType.LANGCHAIN,
@@ -1582,8 +1630,9 @@ def run_interactive_prompts() -> ProjectConfig:
         ("Observability (Logfire)", step_logfire),
         ("Agent Sandbox", step_sandbox_backend),
         ("LLM Provider", step_llm_provider),
-        ("PydanticAI Capabilities", step_pydantic_capabilities),
+        ("Web Search & Fetch", step_web_capabilities),
         ("RAG", step_rag_config),
+        ("Chart Tool", step_charts),
         ("LangSmith", step_langsmith),
         ("Messaging Channels", step_channels),
         ("Teams & Billing", step_teams_billing),
@@ -1629,6 +1678,7 @@ def run_interactive_prompts() -> ProjectConfig:
     llm_provider = state["llm_provider"]
     enable_web_search = state["enable_web_search"]
     enable_web_fetch = state["enable_web_fetch"]
+    enable_charts = state["enable_charts"]
     rag_features = state["rag_features"]
     enable_langsmith = state["enable_langsmith"]
     use_telegram = state["use_telegram"]
@@ -1670,6 +1720,7 @@ def run_interactive_prompts() -> ProjectConfig:
         enable_langsmith=enable_langsmith,
         enable_web_search=enable_web_search,
         enable_web_fetch=enable_web_fetch,
+        enable_charts=enable_charts,
         use_telegram=use_telegram,
         use_slack=use_slack,
         rate_limit_requests=rate_limit_requests,

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fastapi-fullstack"
-version = "0.2.8"
+version = "0.2.9"
 description = "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."
 readme = "README.md"
 requires-python = ">=3.11"

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/template/VARIABLES.md

@@ -281,8 +281,11 @@ These variables are set automatically by the generator.
 | `use_google` | bool | `false` | Google Gemini is selected | Computed from `llm_provider` |
 | `use_openrouter` | bool | `false` | OpenRouter is selected | Computed from `llm_provider` |
 | `enable_langsmith` | bool | `false` | Enable LangSmith observability (tracing, prompt management) | Requires LangChain, LangGraph, or DeepAgents |
-| `enable_web_search` | bool | `false` | Enable WebSearch capability for PydanticAI agents | PydanticAI only |
-| `enable_web_fetch` | bool | `false` | Enable WebFetch capability for PydanticAI agents | PydanticAI only |
+| `enable_web_search` | bool | `false` | Web search. PydanticAI/PydanticDeep use the model-native WebSearch capability; LangChain/LangGraph/CrewAI/DeepAgents use a Tavily-backed tool (needs `TAVILY_API_KEY`) | Requires an AI framework |
+| `enable_web_fetch` | bool | `false` | Web fetch. PydanticAI/PydanticDeep use the model-native WebFetch capability; LangChain/LangGraph/CrewAI/DeepAgents use the portable `fetch_url` tool | Requires an AI framework |
+| `web_fetch_tool` | bool | `false` | Computed: portable `fetch_url` tool is generated | `enable_web_fetch` and framework is LangChain/LangGraph/CrewAI/DeepAgents |
+| `enable_charts` | bool | `false` | Enable the chart-generation tool (line/bar/pie/area/scatter); interactive in web chat, PNG on Slack/Telegram | Requires an AI framework |
+| `charts_channel_png` | bool | `false` | Computed: render charts to PNG for messaging channels | `enable_charts` and (`use_slack` or `use_telegram`) |
 
 **Notes:**
 

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/template/cookiecutter.json

@@ -88,6 +88,9 @@
   "enable_langsmith": false,
   "enable_web_search": false,
   "enable_web_fetch": false,
+  "web_fetch_tool": false,
+  "enable_charts": false,
+  "charts_channel_png": false,
   "enable_webhooks": false,
   "websocket_auth": "jwt",
   "websocket_auth_jwt": true,

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/template/hooks/post_gen_project.py

@@ -45,6 +45,9 @@ enable_rag_image_description = "{{ cookiecutter.enable_rag_image_description }}"
 enable_google_drive_ingestion = "{{ cookiecutter.enable_google_drive_ingestion }}" == "True"
 enable_s3_ingestion = "{{ cookiecutter.enable_s3_ingestion }}" == "True"
 enable_web_search = "{{ cookiecutter.enable_web_search }}" == "True"
+web_fetch_tool = "{{ cookiecutter.web_fetch_tool }}" == "True"
+enable_charts = "{{ cookiecutter.enable_charts }}" == "True"
+charts_channel_png = "{{ cookiecutter.charts_channel_png }}" == "True"
 use_pydantic_deep = "{{ cookiecutter.use_pydantic_deep }}" == "True"
 use_telegram = "{{ cookiecutter.use_telegram }}" == "True"
 use_slack = "{{ cookiecutter.use_slack }}" == "True"
@@ -126,6 +129,20 @@ if not use_pydantic_deep:
     remove_file(os.path.join(backend_app, "agents", "pydantic_deep_assistant.py"))
 if not enable_web_search:
     remove_file(os.path.join(backend_app, "agents", "tools", "web_search.py"))
+    remove_file(os.path.join(os.getcwd(), "backend", "tests", "test_web_search.py"))
+if not web_fetch_tool:
+    remove_file(os.path.join(backend_app, "agents", "tools", "fetch_url.py"))
+    remove_file(os.path.join(os.getcwd(), "backend", "tests", "test_fetch_url.py"))
+if not enable_charts:
+    remove_file(os.path.join(backend_app, "agents", "tools", "chart_tool.py"))
+    remove_file(os.path.join(backend_app, "agents", "tools", "chart_render.py"))
+    remove_file(os.path.join(os.getcwd(), "backend", "tests", "test_chart_tool.py"))
+    if use_frontend:
+        frontend_src = os.path.join(os.getcwd(), "frontend", "src")
+        remove_file(os.path.join(frontend_src, "components", "chat", "chart-message.tsx"))
+elif not charts_channel_png:
+    # Chart tool enabled but no Slack/Telegram — PNG renderer not needed.
+    remove_file(os.path.join(backend_app, "agents", "tools", "chart_render.py"))
 
 # --- No-AI mode: remove all AI/chat/conversation files ---
 if not use_ai:
@@ -326,7 +343,6 @@ if not enable_docker:
         "docker-compose.dev.yml",
         "docker-compose.prod.yml",
         "docker-compose.frontend.yml",
-        ".env.prod.example",
     ):
         remove_file(os.path.join(project_root, compose_file))
 

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/template/{{cookiecutter.project_slug}}/.gitignore

@@ -55,7 +55,6 @@ coverage.xml
 .env
 .env.local
 .env.*.local
-.env.prod
 .venv
 env/
 venv/

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/template/{{cookiecutter.project_slug}}/ENV_VARS.md

@@ -54,7 +54,7 @@ group is for and which are required vs optional.
 | Variable | Required | Default | Description |
 |---|---|---|---|
 | `OPENAI_API_KEY` | **required** | — | From platform.openai.com |
-| `AI_MODEL` | optional | `gpt-4o-mini` | Default model used by agent |
+| `AI_MODEL` | optional | `gpt-5.5` | Default model used by agent (provider-specific) |
 {%- endif %}
 {%- if cookiecutter.use_anthropic %}
 | `ANTHROPIC_API_KEY` | **required** | — | From console.anthropic.com |

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/template/{{cookiecutter.project_slug}}/Makefile

@@ -3,7 +3,7 @@
 # === Environments ===========================================================
 # `make dev`   — local development (docker-compose.dev.yml + bind-mounted source)
 # `make stage` — staging (docker-compose.yml — built images, no live reload)
-# `make prod`  — production (docker-compose.prod.yml — needs .env.prod + nginx)
+# `make prod`  — production (docker-compose.prod.yml — needs backend/.env + nginx)
 # Each env has matching -down / -logs / -rebuild siblings.
 
 {%- if cookiecutter.enable_docker and (cookiecutter.use_postgresql or cookiecutter.use_sqlite) %}
@@ -121,22 +121,22 @@ stage:
 stage-down:
 	docker compose -f docker-compose.yml down
 
-# === Production: external Nginx, .env.prod required, real secrets ===
+# === Production: external Nginx, real secrets in backend/.env ===
 prod:
-	@test -f .env.prod || (echo "❌ .env.prod missing — copy from .env.prod.example and fill in values" && exit 1)
-	docker compose -f docker-compose.prod.yml up -d --build
+	@test -f backend/.env || (echo "❌ backend/.env missing — run 'cp backend/.env.example backend/.env' and fill in real secrets" && exit 1)
+	docker compose --env-file backend/.env -f docker-compose.prod.yml up -d --build
 {%- if cookiecutter.use_postgresql or cookiecutter.use_sqlite %}
 	@echo "▶ Waiting for DB then running migrations…"
 	@sleep 5
-	docker compose -f docker-compose.prod.yml exec -T app {{ cookiecutter.project_slug }} db upgrade
+	docker compose --env-file backend/.env -f docker-compose.prod.yml exec -T app {{ cookiecutter.project_slug }} db upgrade
 {%- endif %}
 	@echo "✅ Production stack up. Configure your nginx host with nginx/nginx.conf"
 
 prod-down:
-	docker compose -f docker-compose.prod.yml down
+	docker compose --env-file backend/.env -f docker-compose.prod.yml down
 
 prod-logs:
-	docker compose -f docker-compose.prod.yml logs -f
+	docker compose --env-file backend/.env -f docker-compose.prod.yml logs -f
 
 # Legacy alias
 quickstart: dev
@@ -430,7 +430,7 @@ help:
 	@echo ""
 	@echo "📦 Other environments:"
 	@echo "  make stage          Production-like stack on localhost (no bind mounts)"
-	@echo "  make prod           Production stack (requires .env.prod + nginx)"
+	@echo "  make prod           Production stack (requires backend/.env + nginx)"
 	@echo ""
 {%- endif %}
 	@echo "Setup (without Docker):"

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/template/{{cookiecutter.project_slug}}/README.md

@@ -123,7 +123,7 @@ make run           # run uvicorn locally with --reload
 |---|---|---|
 | `make dev` | `docker-compose.dev.yml` | Local development with hot-reload + bind-mounted source. |
 | `make stage` | `docker-compose.yml` | Production-like build, no bind mounts, runs on localhost. Good for sanity-checking before deploy. |
-| `make prod` | `docker-compose.prod.yml` | Production. Requires `.env.prod` (copy from `.env.prod.example`) and an external Nginx using `nginx/nginx.conf`. |
+| `make prod` | `docker-compose.prod.yml` | Production. Requires `backend/.env` (copy from `backend/.env.example`, fill real secrets) and an external Nginx using `nginx/nginx.conf`. |
 
 Each env has matching `-down`, `-logs`, `-rebuild` siblings (e.g. `make stage-down`).
 
@@ -251,7 +251,7 @@ EMAIL_FROM=noreply@your-domain.com
 
 See `backend/.env.example` for the full list with comments.
 
-For production, **never** commit secrets — copy `.env.prod.example` → `.env.prod` and inject via your platform's secret manager (Doppler, AWS Secrets Manager, GitHub Actions secrets, etc.).
+For production, **never** commit secrets — `backend/.env` is gitignored. Fill it with real values on the server (or inject them via your platform's secret manager: Doppler, AWS Secrets Manager, GitHub Actions secrets, etc.). The same `backend/.env` is used for dev and prod — there is no separate `.env.prod`.
 
 ---
 
@@ -346,7 +346,7 @@ Set in the Vercel dashboard:
 
 ```bash
 # 1. SSH to the box, clone the repo
-# 2. Copy .env.prod.example → .env.prod, fill in real secrets
+# 2. cp backend/.env.example backend/.env, fill in real secrets
 # 3. Configure nginx using nginx/nginx.conf as reference
 # 4. Bring up the stack:
 make prod

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/template/{{cookiecutter.project_slug}}/backend/.env.example

@@ -217,15 +217,15 @@ OPENROUTER_API_KEY=
 {%- if cookiecutter.use_all_providers %}
 # Multi-provider deployment — model name must include the provider prefix:
 #   openai/<model>, anthropic/<model>, google/<model>, openrouter/<provider>/<model>
-AI_MODEL=openai/gpt-4.1-mini
+AI_MODEL=openai/gpt-5.5
 {%- elif cookiecutter.use_openai %}
-AI_MODEL=gpt-4.1-mini
+AI_MODEL=gpt-5.5
 {%- elif cookiecutter.use_anthropic %}
-AI_MODEL=claude-sonnet-4-6
+AI_MODEL=claude-opus-4-7
 {%- elif cookiecutter.use_google %}
 AI_MODEL=gemini-2.5-flash
 {%- elif cookiecutter.use_openrouter %}
-AI_MODEL=anthropic/claude-sonnet-4-6
+AI_MODEL=anthropic/claude-opus-4-7
 {%- endif %}
 AI_TEMPERATURE=0.7
 {%- if cookiecutter.use_pydantic_ai %}

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/template/{{cookiecutter.project_slug}}/backend/app/agents/assistant.py

@@ -51,6 +51,9 @@ from app.agents.tools import get_current_datetime
 {%- if cookiecutter.enable_rag %}
 from app.agents.tools.rag_tool import search_knowledge_base
 {%- endif %}
+{%- if cookiecutter.enable_charts %}
+from app.agents.tools.chart_tool import create_chart
+{%- endif %}
 from app.core.config import settings
 
 logger = logging.getLogger(__name__)
@@ -250,6 +253,41 @@ class AssistantAgent:
 {%- endif %}
 {%- endif %}
 
+{%- if cookiecutter.enable_charts %}
+        @agent.tool_plain
+        def create_chart_tool(
+            chart_type: str,
+            title: str,
+            data: list[dict[str, Any]],
+            series: list[dict[str, Any]] | None = None,
+            x_key: str = "x",
+            style: dict[str, Any] | None = None,
+        ) -> str:
+            """Create a chart (line/bar/pie/area/scatter) to visualize data for the user.
+
+            Use whenever the user asks to plot, chart, graph, or visualize numbers,
+            trends, comparisons, or distributions. Do not repeat the returned JSON
+            back to the user — just briefly describe the chart you created.
+
+            Args:
+                chart_type: One of "line", "bar", "pie", "area", "scatter".
+                title: Short chart title.
+                data: Row dicts, e.g. [{"x": "Jan", "revenue": 120}]. For pie:
+                    [{"x": "Chrome", "value": 64}, ...].
+                series: Optional [{"key", "label"?, "color"?}] selecting fields to plot.
+                x_key: Row field for the x-axis / pie label (default "x").
+                style: Optional {"palette", "grid", "legend", "x_label", "y_label", "stacked"}.
+            """
+            return create_chart(
+                chart_type=chart_type,  # type: ignore[arg-type]
+                title=title,
+                data=data,
+                series=series,
+                x_key=x_key,
+                style=style,
+            )
+{%- endif %}
+
 
     @staticmethod
     def _build_model_history(

{fastapi_fullstack-0.2.8 → fastapi_fullstack-0.2.9}/template/{{cookiecutter.project_slug}}/backend/app/agents/crewai_assistant.py

@@ -289,6 +289,17 @@ class CrewAIAssistant:
 {%- else %}
         research_tools = []
         task_description_suffix = ""
+{%- endif %}
+{%- if cookiecutter.enable_web_search %}
+        research_tools.append("search_web")
+{%- endif %}
+{%- if cookiecutter.web_fetch_tool %}
+        research_tools.append("fetch_url")
+{%- endif %}
+{%- if cookiecutter.enable_charts %}
+        writer_tools = ["create_chart"]
+{%- else %}
+        writer_tools = []
 {%- endif %}
         return CrewConfig(
             name="assistant_crew",
@@ -306,7 +317,7 @@ class CrewAIAssistant:
                     role="Content Writer",
                     goal="Create clear, well-structured responses for the user",
                     backstory="You are a skilled writer who produces high-quality, readable content. You take research findings and transform them into helpful responses.",
-                    tools=[],
+                    tools=writer_tools,
                     allow_delegation=False,
                 ),
             ],
@@ -385,6 +396,54 @@ class CrewAIAssistant:
                 """Search the web for current information."""
                 return web_search_sync(query=query)
             tool_map["search_web"] = search_web
+{%- endif %}
+{%- if cookiecutter.web_fetch_tool %}
+            from app.agents.tools.fetch_url import fetch_url_sync
+            from langchain_core.tools import tool as lc_tool_fetch
+
+            @lc_tool_fetch
+            def fetch_url(url: str) -> str:
+                """Fetch a web page and return its readable text content."""
+                return fetch_url_sync(url=url)
+
+            tool_map["fetch_url"] = fetch_url
+{%- endif %}
+{%- if cookiecutter.enable_charts %}
+            from app.agents.tools.chart_tool import create_chart
+            from langchain_core.tools import tool as lc_tool_charts
+
+            @lc_tool_charts
+            def create_chart_tool(
+                chart_type: str,
+                title: str,
+                data: list[dict[str, Any]],
+                series: list[dict[str, Any]] | None = None,
+                x_key: str = "x",
+                style: dict[str, Any] | None = None,
+            ) -> str:
+                """Create a chart (line/bar/pie/area/scatter) to visualize data.
+
+                Use whenever the user asks to plot/chart/graph/visualize numbers.
+                Do not repeat the returned JSON back — just describe the chart.
+
+                Args:
+                    chart_type: "line", "bar", "pie", "area", or "scatter".
+                    title: Short chart title.
+                    data: Row dicts, e.g. [{"x": "Jan", "revenue": 120}].
+                    series: Optional [{"key", "label"?, "color"?}].
+                    x_key: Row field for the x-axis / pie label (default "x").
+                    style: Optional {"palette", "grid", "legend", "x_label", "y_label", "stacked"}.
+                """
+                return create_chart(
+                    chart_type=chart_type,  # type: ignore[arg-type]
+                    title=title,
+                    data=data,
+                    series=series,
+                    x_key=x_key,
+                    style=style,
+                )
+
+            tool_map["create_chart"] = create_chart_tool
 {%- endif %}
             return [tool_map[name] for name in agent_tools if name in tool_map]