fastapi-fullstack 0.2.10__tar.gz → 0.2.12__tar.gz

{fastapi_fullstack-0.2.10 → fastapi_fullstack-0.2.12}/.gitignore

@@ -3,6 +3,7 @@ notes/
 .vscode/
 .DS_Store
 test7/
+ai_agent_test/
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[codz]

{fastapi_fullstack-0.2.10 → fastapi_fullstack-0.2.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-fullstack
-Version: 0.2.10
+Version: 0.2.12
 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

{fastapi_fullstack-0.2.10 → fastapi_fullstack-0.2.12}/fastapi_gen/cli.py

@@ -471,6 +471,31 @@ def new(output: Path | None, no_input: bool, name: str | None, minimal: bool) ->
     default=False,
     help="Enable the chart-generation tool for AI agents (line/bar/pie/area/scatter)",
 )
+@click.option(
+    "--antv-charts",
+    is_flag=True,
+    default=False,
+    help="Enable AntV advanced-diagram tools (flowchart, mind-map, sankey, ...) via an "
+    "mcp-server-chart sidecar, plus an interactive Leaflet/OpenStreetMap map tool",
+)
+@click.option(
+    "--code-execution",
+    is_flag=True,
+    default=False,
+    help="Enable the run_python code-execution tool backed by the Monty sandbox (PydanticAI only)",
+)
+@click.option(
+    "--skills",
+    is_flag=True,
+    default=False,
+    help="Enable the skills system (SkillsToolset loads SKILL.md files from backend/skills/, PydanticAI only)",
+)
+@click.option(
+    "--deep-research",
+    is_flag=True,
+    default=False,
+    help="Enable the deep research agent (TODO planner + subagents + context manager, PydanticAI only)",
+)
 @click.option("--session-management", is_flag=True, help="Enable session management")
 @click.option(
     "--reverse-proxy",
@@ -746,6 +771,10 @@ def create(
     web_search: bool,
     web_fetch: bool,
     charts: bool,
+    antv_charts: bool,
+    code_execution: bool,
+    skills: bool,
+    deep_research: bool,
     session_management: bool,
     reverse_proxy: str,
     kubernetes: bool,
@@ -1174,6 +1203,10 @@ def create(
                 enable_web_search=web_search,
                 enable_web_fetch=web_fetch,
                 enable_charts=charts,
+                enable_antv_charts=antv_charts,
+                enable_code_execution=code_execution,
+                enable_skills=skills,
+                enable_deep_research=deep_research,
                 enable_session_management=session_management,
                 reverse_proxy=_rp_map[reverse_proxy],
                 enable_kubernetes=kubernetes,

{fastapi_fullstack-0.2.10 → fastapi_fullstack-0.2.12}/fastapi_gen/config.py

@@ -325,6 +325,10 @@ class ProjectConfig(BaseModel):
     enable_web_search: bool = False
     enable_web_fetch: bool = False
     enable_charts: bool = False
+    enable_antv_charts: bool = False
+    enable_code_execution: bool = False
+    enable_skills: bool = False
+    enable_deep_research: bool = False
     use_telegram: bool = False
     use_slack: bool = False
     enable_cors: bool = True
@@ -487,6 +491,12 @@ class ProjectConfig(BaseModel):
                 "PydanticDeep uses Logfire for observability."
             )
 
+        if self.enable_deep_research and self.ai_framework != AIFrameworkType.PYDANTIC_AI:
+            raise ValueError(
+                "Deep research requires the PydanticAI framework. "
+                "Quick fix: set --ai-framework pydantic_ai, or drop --deep-research."
+            )
+
         # CrewAI 1.13.x pins opentelemetry-sdk<1.35 which conflicts with
         # logfire>=4.30 (needs opentelemetry-sdk>=1.39). Disable logfire when
         # using CrewAI to keep dependencies resolvable.
@@ -811,6 +821,10 @@ class ProjectConfig(BaseModel):
             ),
             "enable_charts": self.enable_charts,
             "charts_channel_png": self.enable_charts and (self.use_slack or self.use_telegram),
+            "enable_antv_charts": self.enable_antv_charts,
+            "enable_code_execution": self.enable_code_execution,
+            "enable_skills": self.enable_skills,
+            "enable_deep_research": self.enable_deep_research,
             "enable_webhooks": self.enable_webhooks,
             # Legacy fixed values (WebSocket always uses JWT)
             "websocket_auth": "jwt",

{fastapi_fullstack-0.2.10 → fastapi_fullstack-0.2.12}/fastapi_gen/prompts.py

@@ -896,6 +896,104 @@ def prompt_charts() -> bool:
     )
 
 
+def prompt_antv_charts() -> bool:
+    """Prompt for the AntV advanced-diagram tools + interactive map tool.
+
+    Returns:
+        Whether the AntV / map tools are enabled.
+    """
+    console.print()
+    console.print("[bold cyan]AntV Diagrams & Maps[/]")
+    console.print(
+        "Adds an interactive map tool (Leaflet/OpenStreetMap, works out of the "
+        "box) plus AntV advanced-diagram tools (flowchart, mind-map, org-chart, "
+        "sankey, ...) served by an mcp-server-chart Docker sidecar. The diagrams "
+        "need the sidecar running (docker compose --profile antv up -d); maps work "
+        "without it."
+    )
+    console.print()
+
+    return cast(
+        bool,
+        _check_cancelled(
+            questionary.confirm(
+                "Enable AntV diagram + map tools for the agent?",
+                default=False,
+            ).ask()
+        ),
+    )
+
+
+def prompt_code_execution() -> bool:
+    """Prompt for the Monty-backed run_python code-execution tool (PydanticAI only)."""
+    console.print()
+    console.print("[bold cyan]Code Execution (Monty sandbox)[/]")
+    console.print(
+        "Adds a `run_python` tool that lets the agent execute Python in a sandboxed "
+        "interpreter (pydantic-monty). The model can compute projections, run "
+        "aggregations, and call create_chart/create_map directly from inside the "
+        "code. Restricted stdlib: math, asyncio, json, datetime, re — no numpy/pandas. "
+        "PydanticAI only. Activate at runtime with ENABLE_CODE_EXECUTION=true."
+    )
+    console.print()
+
+    return cast(
+        bool,
+        _check_cancelled(
+            questionary.confirm(
+                "Enable the run_python code-execution tool (PydanticAI only)?",
+                default=False,
+            ).ask()
+        ),
+    )
+
+
+def prompt_skills() -> bool:
+    """Prompt for the skills system (SkillsToolset, PydanticAI only)."""
+    console.print()
+    console.print("[bold cyan]Skills System (pydantic-ai-skills)[/]")
+    console.print(
+        "Adds a SkillsToolset that loads SKILL.md files from `backend/skills/` as "
+        "agent tools. Drop in your own skills; pair with code execution (Monty "
+        "sandbox) for skills that compute. PydanticAI only."
+    )
+    console.print()
+
+    return cast(
+        bool,
+        _check_cancelled(
+            questionary.confirm(
+                "Enable the skills system (PydanticAI only)?",
+                default=False,
+            ).ask()
+        ),
+    )
+
+
+def prompt_deep_research() -> bool:
+    """Prompt for the deep research agent (PydanticAI only)."""
+    console.print()
+    console.print("[bold cyan]Deep Research Agent[/]")
+    console.print(
+        "Turns the assistant into a deep research agent: a TODO planner, "
+        "researcher/analyst/writer subagents, and an automatic context manager. "
+        "The planner delegates web work to subagents and surfaces progress in a "
+        "live research panel. PydanticAI only. Activate at runtime with "
+        "ENABLE_DEEP_RESEARCH=true."
+    )
+    console.print()
+
+    return cast(
+        bool,
+        _check_cancelled(
+            questionary.confirm(
+                "Enable the deep research agent (PydanticAI only)?",
+                default=False,
+            ).ask()
+        ),
+    )
+
+
 def prompt_langsmith() -> bool:
     """Prompt for LangSmith observability."""
     return cast(
@@ -1405,6 +1503,10 @@ def run_interactive_prompts() -> ProjectConfig:
         "enable_web_search": False,
         "enable_web_fetch": False,
         "enable_charts": False,
+        "enable_antv_charts": False,
+        "enable_code_execution": False,
+        "enable_skills": False,
+        "enable_deep_research": False,
         "rag_features": RAGFeatures(),
         "orm_type": OrmType.SQLALCHEMY,
         "sandbox_backend": "state",
@@ -1563,6 +1665,30 @@ def run_interactive_prompts() -> ProjectConfig:
         else:
             state["enable_charts"] = prompt_charts()
 
+    def step_antv_charts() -> None:
+        if state["ai_framework"] == AIFrameworkType.NONE:
+            state["enable_antv_charts"] = False
+        else:
+            state["enable_antv_charts"] = prompt_antv_charts()
+
+    def step_code_execution() -> None:
+        if state["ai_framework"] == AIFrameworkType.PYDANTIC_AI:
+            state["enable_code_execution"] = prompt_code_execution()
+        else:
+            state["enable_code_execution"] = False
+
+    def step_skills() -> None:
+        if state["ai_framework"] == AIFrameworkType.PYDANTIC_AI:
+            state["enable_skills"] = prompt_skills()
+        else:
+            state["enable_skills"] = False
+
+    def step_deep_research() -> None:
+        if state["ai_framework"] == AIFrameworkType.PYDANTIC_AI:
+            state["enable_deep_research"] = prompt_deep_research()
+        else:
+            state["enable_deep_research"] = False
+
     def step_langsmith() -> None:
         if state["ai_framework"] in (
             AIFrameworkType.LANGCHAIN,
@@ -1633,6 +1759,10 @@ def run_interactive_prompts() -> ProjectConfig:
         ("Web Search & Fetch", step_web_capabilities),
         ("RAG", step_rag_config),
         ("Chart Tool", step_charts),
+        ("AntV Diagrams & Maps", step_antv_charts),
+        ("Code Execution", step_code_execution),
+        ("Skills System", step_skills),
+        ("Deep Research", step_deep_research),
         ("LangSmith", step_langsmith),
         ("Messaging Channels", step_channels),
         ("Teams & Billing", step_teams_billing),
@@ -1679,6 +1809,10 @@ def run_interactive_prompts() -> ProjectConfig:
     enable_web_search = state["enable_web_search"]
     enable_web_fetch = state["enable_web_fetch"]
     enable_charts = state["enable_charts"]
+    enable_antv_charts = state["enable_antv_charts"]
+    enable_code_execution = state["enable_code_execution"]
+    enable_skills = state["enable_skills"]
+    enable_deep_research = state["enable_deep_research"]
     rag_features = state["rag_features"]
     enable_langsmith = state["enable_langsmith"]
     use_telegram = state["use_telegram"]
@@ -1721,6 +1855,10 @@ def run_interactive_prompts() -> ProjectConfig:
         enable_web_search=enable_web_search,
         enable_web_fetch=enable_web_fetch,
         enable_charts=enable_charts,
+        enable_antv_charts=enable_antv_charts,
+        enable_code_execution=enable_code_execution,
+        enable_skills=enable_skills,
+        enable_deep_research=enable_deep_research,
         use_telegram=use_telegram,
         use_slack=use_slack,
         rate_limit_requests=rate_limit_requests,

{fastapi_fullstack-0.2.10 → fastapi_fullstack-0.2.12}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fastapi-fullstack"
-version = "0.2.10"
+version = "0.2.12"
 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.10 → fastapi_fullstack-0.2.12}/template/VARIABLES.md

@@ -286,6 +286,10 @@ These variables are set automatically by the generator.
 | `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`) |
+| `enable_antv_charts` | bool | `false` | Adds the interactive `create_map` tool (Leaflet/OpenStreetMap, works out of the box) plus AntV advanced-diagram tools (flowchart, mind-map, org-chart, sankey, ...) via an `mcp-server-chart` Docker sidecar. Wired into all 5 frameworks. The AntV diagrams need the sidecar running (`docker compose --profile antv up -d`) and `ENABLE_ANTV_CHARTS=true` at runtime; maps work without it. Present in the production compose but profile-gated — off by default and publishes no host port, so it's opt-in per environment; for prod, self-host GPT-Vis-SSR via `ANTV_VIS_REQUEST_SERVER` rather than AntV's public render backend | Requires an AI framework |
+| `enable_code_execution` | bool | `false` | Adds a `run_python` tool backed by the Monty sandboxed Python interpreter (`pydantic-monty`). The model can compute projections, run aggregations, and call `create_chart`/`create_map` from inside the sandbox — charts render as interactive Recharts cards immediately. Sandbox allows `math`, `asyncio`, `json`, `datetime`, `re`; no `statistics`, `random`, `itertools`, numpy/pandas. Activated at runtime with `ENABLE_CODE_EXECUTION=true`. **PydanticAI only.** Temporary shim — swap to the official `CodeExecutionToolset` when it ships in pydantic-ai | Requires `use_pydantic_ai` |
+| `enable_skills` | bool | `false` | Adds a `pydantic-ai-skills` `SkillsToolset` that loads `SKILL.md` files from `backend/skills/` as agent tools (the model picks a skill, then follows its instructions). Ships the loader only — drop your own skills into `backend/skills/`; the toolset no-ops when the directory is empty. Pairs well with `enable_code_execution` for skills that compute. **PydanticAI only.** | Requires `use_pydantic_ai` |
+| `enable_deep_research` | bool | `false` | Turns the assistant into a deep research agent: a TODO planner (`pydantic-ai-todo`), researcher/analyst/writer subagents (`subagents-pydantic-ai`), and an automatic context manager (`summarization-pydantic-ai`). The planner delegates web work to subagents and streams a live research panel (plan checklist, subagent status, context-usage meter). TODO state persists in PostgreSQL when available, else in memory. Activated at runtime with `ENABLE_DEEP_RESEARCH=true`; the client can opt a single turn out with `deep_research=false`. **PydanticAI only.** | Requires `use_pydantic_ai` |
 
 **Notes:**
 

{fastapi_fullstack-0.2.10 → fastapi_fullstack-0.2.12}/template/cookiecutter.json

@@ -91,6 +91,10 @@
   "web_fetch_tool": false,
   "enable_charts": false,
   "charts_channel_png": false,
+  "enable_antv_charts": false,
+  "enable_code_execution": false,
+  "enable_skills": false,
+  "enable_deep_research": false,
   "enable_webhooks": false,
   "websocket_auth": "jwt",
   "websocket_auth_jwt": true,

{fastapi_fullstack-0.2.10 → fastapi_fullstack-0.2.12}/template/hooks/post_gen_project.py

@@ -48,6 +48,9 @@ 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"
+enable_antv_charts = "{{ cookiecutter.enable_antv_charts }}" == "True"
+enable_code_execution = "{{ cookiecutter.enable_code_execution }}" == "True"
+enable_deep_research = "{{ cookiecutter.enable_deep_research }}" == "True"
 use_pydantic_deep = "{{ cookiecutter.use_pydantic_deep }}" == "True"
 use_telegram = "{{ cookiecutter.use_telegram }}" == "True"
 use_slack = "{{ cookiecutter.use_slack }}" == "True"
@@ -117,6 +120,7 @@ print("Cleaning up unused files...")
 # --- AI Agent files (remove unused framework-specific files) ---
 if not use_pydantic_ai:
     remove_file(os.path.join(backend_app, "agents", "assistant.py"))
+    remove_file(os.path.join(backend_app, "agents", "tools", "ask_user_tool.py"))
 if not use_langchain:
     remove_file(os.path.join(backend_app, "agents", "langchain_assistant.py"))
 if not use_langgraph:
@@ -143,6 +147,24 @@ if not enable_charts:
 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"))
+if not enable_antv_charts:
+    # AntV diagram MCP client + the create_map tool + its Leaflet renderer.
+    remove_file(os.path.join(backend_app, "agents", "tools", "antv_chart.py"))
+    remove_file(os.path.join(backend_app, "agents", "tools", "map_tool.py"))
+    if use_frontend:
+        frontend_src = os.path.join(os.getcwd(), "frontend", "src")
+        remove_file(os.path.join(frontend_src, "components", "chat", "map-leaflet.tsx"))
+        remove_file(os.path.join(frontend_src, "components", "chat", "map-message.tsx"))
+if not enable_code_execution:
+    remove_file(os.path.join(backend_app, "agents", "tools", "code_execution.py"))
+if not enable_deep_research:
+    remove_file(os.path.join(backend_app, "services", "research.py"))
+    remove_file(os.path.join(backend_app, "db", "todo_pool.py"))
+    if use_frontend:
+        frontend_src = os.path.join(os.getcwd(), "frontend", "src")
+        remove_file(os.path.join(frontend_src, "components", "chat", "research-panel.tsx"))
+        remove_file(os.path.join(frontend_src, "stores", "research-store.ts"))
+        remove_file(os.path.join(frontend_src, "stores", "chat-mode-store.ts"))
 
 # --- No-AI mode: remove all AI/chat/conversation files ---
 if not use_ai:
@@ -427,12 +449,14 @@ if not use_any_background_tasks:
     remove_file(os.path.join(worker_dir, "taskiq_app.py"))
     remove_file(os.path.join(worker_dir, "arq_app.py"))
     remove_dir(os.path.join(worker_dir, "tasks"))
+    remove_file(os.path.join(backend_tests, "test_worker_taskiq.py"))
 else:
     if not use_celery:
         remove_file(os.path.join(worker_dir, "celery_app.py"))
     if not use_taskiq:
         remove_file(os.path.join(worker_dir, "taskiq_app.py"))
         remove_file(os.path.join(worker_dir, "tasks", "schedules.py"))
+        remove_file(os.path.join(backend_tests, "test_worker_taskiq.py"))
     if not use_arq:
         remove_file(os.path.join(worker_dir, "arq_app.py"))
 

{fastapi_fullstack-0.2.10 → fastapi_fullstack-0.2.12}/template/{{cookiecutter.project_slug}}/Makefile

@@ -23,6 +23,12 @@ endef
 {%- endif %}
 
 {%- if cookiecutter.enable_docker %}
+{%- if cookiecutter.enable_antv_charts %}
+
+# Fold the opt-in "antv" profile into `make dev` so the diagram sidecar starts
+# automatically alongside db/app. The agent connects only when ENABLE_ANTV_CHARTS=true.
+COMPOSE_DEV_PROFILES := --profile antv
+{%- endif %}
 
 # === Local dev: build → up → migrate ===
 # Idempotent — re-run anytime. Migrations are no-ops when already at head;
@@ -32,12 +38,12 @@ dev:
 	@echo "▶ Building backend image…"
 	docker compose -f docker-compose.dev.yml build app
 	@echo "▶ Starting services…"
-	@if ! docker compose -f docker-compose.dev.yml up -d; then \
+	@if ! docker compose -f docker-compose.dev.yml $(COMPOSE_DEV_PROFILES) up -d; then \
 		echo ""; \
 		echo "⚠ First start failed. Tearing down stale containers and retrying once…"; \
 		echo "  (volumes preserved — DB data is safe; use 'make clean' for a full wipe)"; \
 		docker compose -f docker-compose.dev.yml down --remove-orphans; \
-		docker compose -f docker-compose.dev.yml up -d; \
+		docker compose -f docker-compose.dev.yml $(COMPOSE_DEV_PROFILES) up -d; \
 	fi
 {%- if cookiecutter.use_postgresql or cookiecutter.use_sqlite %}
 	$(call _wait_for_db,docker-compose.dev.yml)
@@ -85,18 +91,18 @@ bootstrap: dev
 {%- endif %}
 
 dev-down:
-	docker compose -f docker-compose.dev.yml down
+	docker compose -f docker-compose.dev.yml $(COMPOSE_DEV_PROFILES) down
 
 # Full wipe — containers, networks, AND volumes. Use after a corrupted state
 # (e.g. detached networks, port conflicts that left orphans). DESTROYS DB data.
 docker-clean:
 	@echo "▶ Removing containers, networks, AND volumes for the dev stack…"
 	@echo "  ⚠️  This deletes all local DB data and uploaded files."
-	docker compose -f docker-compose.dev.yml down -v --remove-orphans
+	docker compose -f docker-compose.dev.yml $(COMPOSE_DEV_PROFILES) down -v --remove-orphans
 	@echo "✅ Cleaned. Run 'make dev' to start fresh."
 
 dev-logs:
-	docker compose -f docker-compose.dev.yml logs -f
+	docker compose -f docker-compose.dev.yml $(COMPOSE_DEV_PROFILES) logs -f
 
 dev-rebuild:
 	docker compose -f docker-compose.dev.yml build --no-cache app
@@ -277,8 +283,8 @@ taskiq-scheduler:
 
 # === Docker: Backend (Development) ===
 docker-up:
-	docker-compose build app
-	docker-compose up -d
+	docker compose build app
+	docker compose up -d
 	@echo ""
 	@echo "✅ Backend services started!"
 	@echo "   API: http://localhost:{{ cookiecutter.backend_port }}"
@@ -294,25 +300,25 @@ docker-up:
 {%- endif %}
 
 docker-down:
-	docker-compose down
+	docker compose down
 {%- if cookiecutter.use_frontend %}
-	docker-compose -f docker-compose.frontend.yml down 2>/dev/null || true
+	docker compose -f docker-compose.frontend.yml down 2>/dev/null || true
 {%- endif %}
 
 docker-logs:
-	docker-compose logs -f
+	docker compose logs -f
 
 docker-build:
-	docker-compose build
+	docker compose build
 
 docker-shell:
-	docker-compose exec app /bin/bash
+	docker compose exec app /bin/bash
 
 {%- if cookiecutter.use_frontend %}
 
 # === Docker: Frontend (Development) ===
 docker-frontend:
-	docker-compose -f docker-compose.frontend.yml up -d
+	docker compose -f docker-compose.frontend.yml up -d
 	@echo ""
 	@echo "✅ Frontend started!"
 	@echo "   URL: http://localhost:{{ cookiecutter.frontend_port }}"
@@ -320,18 +326,18 @@ docker-frontend:
 	@echo "Note: Backend must be running (make docker-up)"
 
 docker-frontend-down:
-	docker-compose -f docker-compose.frontend.yml down
+	docker compose -f docker-compose.frontend.yml down
 
 docker-frontend-logs:
-	docker-compose -f docker-compose.frontend.yml logs -f
+	docker compose -f docker-compose.frontend.yml logs -f
 
 docker-frontend-build:
-	docker-compose -f docker-compose.frontend.yml build
+	docker compose -f docker-compose.frontend.yml build
 {%- endif %}
 
 # === Docker: Production (with Traefik) ===
 docker-prod:
-	docker-compose -f docker-compose.prod.yml up -d
+	docker compose -f docker-compose.prod.yml up -d
 	@echo ""
 	@echo "✅ Production services started with Traefik!"
 	@echo ""
@@ -346,36 +352,36 @@ docker-prod:
 	@echo "   Traefik: https://traefik.$$DOMAIN"
 
 docker-prod-down:
-	docker-compose -f docker-compose.prod.yml down
+	docker compose -f docker-compose.prod.yml down
 
 docker-prod-logs:
-	docker-compose -f docker-compose.prod.yml logs -f
+	docker compose -f docker-compose.prod.yml logs -f
 
 docker-prod-build:
-	docker-compose -f docker-compose.prod.yml build
+	docker compose -f docker-compose.prod.yml build
 
 {%- if cookiecutter.use_postgresql %}
 
 # === Docker: Individual Services ===
 docker-db:
-	docker-compose up -d db
+	docker compose up -d db
 	@echo ""
 	@echo "✅ PostgreSQL started on port 5432"
 	@echo "   Connection: postgresql://postgres:postgres@localhost:5432/{{ cookiecutter.project_slug }}"
 
 docker-db-stop:
-	docker-compose stop db
+	docker compose stop db
 {%- endif %}
 
 {%- if cookiecutter.enable_redis %}
 
 docker-redis:
-	docker-compose up -d redis
+	docker compose up -d redis
 	@echo ""
 	@echo "✅ Redis started on port 6379"
 
 docker-redis-stop:
-	docker-compose stop redis
+	docker compose stop redis
 {%- endif %}
 
 {%- if cookiecutter.use_frontend %}

{fastapi_fullstack-0.2.10 → fastapi_fullstack-0.2.12}/template/{{cookiecutter.project_slug}}/backend/.env.example

@@ -238,6 +238,33 @@ AI_THINKING_EFFORT=medium  # low, medium, high
 # Get your API key at https://tavily.com
 TAVILY_API_KEY=
 {%- endif %}
+{%- if cookiecutter.enable_antv_charts %}
+
+# === AntV charts (advanced diagrams via mcp-server-chart sidecar) ===
+# Opt-in. The create_map tool works without this; only the AntV diagram tools
+# need the sidecar, which `make dev` starts automatically.
+ENABLE_ANTV_CHARTS=false
+# MCP endpoint of the antvis-chart sidecar (default matches docker-compose).
+ANTV_MCP_URL=http://antvis-chart:1122/mcp
+# Optional self-hosted GPT-Vis render backend (empty = AntV's public service).
+ANTV_VIS_REQUEST_SERVER=
+# Comma-separated AntV tools to disable. Leave empty to use the sidecar's
+# default (drops basic charts that overlap create_chart, and China-only maps).
+ANTV_DISABLED_TOOLS=
+{%- endif %}
+{%- if cookiecutter.enable_code_execution %}
+
+# === Code execution (Monty sandbox) ===
+ENABLE_CODE_EXECUTION=true
+CODE_EXECUTION_TIMEOUT_SECS=10
+CODE_EXECUTION_MAX_ALLOCATIONS=50000000
+{%- endif %}
+{%- if cookiecutter.enable_deep_research %}
+
+ENABLE_DEEP_RESEARCH=true
+DEEP_RESEARCH_MAX_TOKENS=120000
+DEEP_RESEARCH_COMPRESS_THRESHOLD=0.8
+{%- endif %}
 {%- if cookiecutter.enable_langsmith %}
 
 # === LangSmith Observability ===