django-saas-starter

Build AI agents with Pydantic AI — tools, capabilities (including on-demand loading), structured output, streaming, testing, and multi-agent patterns. Use when the user mentions Pydantic AI, imports pydantic_ai, or asks to build an AI agent, add tools/capabilities, defer capability loading, stream output, define agents from YAML, or test agent behavior.

Extend Pydantic AI agents with batteries-included capabilities from pydantic-ai-harness — currently Code Mode, which collapses many tool calls into one sandboxed Python execution. Use when the user mentions pydantic-ai-harness, CodeMode, Monty, code mode, or tool sandboxing, when they want an agent to run agent-written Python, or when a Pydantic AI agent would benefit from orchestrating multiple tool calls in a single sandboxed script.

Use when planning, implementing, testing, reviewing, or evaluating agent-driven changes in this generated Django SaaS app, especially changes that cross Django apps, API surfaces, background jobs, frontend templates, docs, CI, or optional integrations.

Use when adding, changing, testing, or debugging Django Q2 background tasks, scheduled jobs, qcluster workers, Redis broker configuration, or ORM broker fallback in this generated Django SaaS app.

Use when running, testing, or debugging the generated Django SaaS app from host terminal commands, optionally with Docker Compose backing services.

Use when changing Django templates, Tailwind CSS, frontend components, layout, responsive behavior, themes, forms, empty states, motion, or UI copy in this generated Django SaaS app.

Use when running Django checks, migrations, pytest, or database debugging against a disposable local Postgres database created by PGSandbox MCP.

Use when adding, changing, testing, or debugging Cookiecutter templates, including cookiecutter.json variables, Jinja-rendered files, hooks, _copy_without_render, optional feature cleanup, and generated-project validation.

Build and review HTMX interactions in Django server-rendered projects, especially generated django-saas-starter apps. Use when adding hx attributes, partial template responses, request.htmx branching, django-htmx response headers, forms, swaps, triggers, redirects, polling, boosted links or forms, or coordinating HTMX with Alpine.js local state.

Use when adding, changing, testing, or debugging Django Ninja API endpoints, schemas, routers, authentication, OpenAPI docs, or API tests in this generated Django SaaS app.

Use when adding, changing, or debugging Alpine.js behavior in this Django SaaS Starter project, especially in Django templates that may also use HTMX partial updates.

Deploy generated Django SaaS Starter apps to CapRover with split server/worker apps.