Abhiix0 · Abhiix0 · Jul 6, 2026 · Jun 27, 2026 · Jun 27, 2026 · Jun 27, 2026
diff --git a/README.md b/README.md
@@ -37,7 +37,7 @@ It's repetitive. It's inconsistent. And you haven't written a single line of *re
 
 | Feature | What it does |
 |---|---|
-| **Intent-based templates** | Backend API (FastAPI / Flask / Django), CLI Application (Typer / Click / Argparse), Automation Tool |
+| **Intent-based templates** | Backend API (FastAPI / Flask / Django), CLI Application (Typer / Click / Argparse), Automation Tool, AI Chatbot |
 | **Extras system** | Opt-in ruff, pytest, Docker, GitHub Actions — installed and wired automatically |
 | **Dependency installation** | `uv add` runs automatically with the right packages for your choices |
 | **Git + uv** | Optionally runs `git init`, `uv init`, and `uv venv` |
@@ -91,8 +91,9 @@ Spawn rejects names with spaces or special characters, and tells you immediately
   1  Backend API
   2  CLI Application
   3  Automation Tool
+  4  AI Chatbot
 
-Choose Template [1-3]: 1
+Choose Template [1-4]: 1
 ```
 
 **Step 3 — Additional prompts** *(template-dependent)*
@@ -273,6 +274,31 @@ uv run python -m src.main
 
 ---
 
+### `[4]` AI Chatbot
+
+Best for: customer support bots, study assistants, conversational AI tools.
+
+```
+my-chatbot/
+├── src/
+│   ├── chatbot/
+│   ├── providers/
+│   ├── prompts/
+│   ├── utils/
+│   └── main.py
+├── tests/
+├── .env.example
+└── README.md
+```
+
+```bash
+cd my-chatbot
+# Add API_KEY to .env
+uv run python -m src.main
+```
+
+---
+
 ## Other Commands
 
 ### `spawn doctor`
@@ -315,7 +341,7 @@ spawn doctor ./path/to/project
 
 ```bash
 spawn version
-# → Spawn v0.5.0
+# → Spawn v0.6.0
 ```
 
 ### Publish to GitHub
@@ -351,7 +377,7 @@ All tests should pass. If they don't, please [open an issue](https://github.com/
 - [x] **Dependency installation** — `uv add` runs automatically after generation (v0.3.0)
 - [x] **CLI Application intent** — Typer, Click, Argparse with Utility/Interactive sub-types (v0.4.0)
 - [x] **Automation Tool intent** — workflow-based automation with logging, tasks, and integrations (v0.5.0)
-- [ ] **AI Chatbot intent** — LLM-integrated chat app scaffold (v0.6.0)
+- [x] **AI Chatbot intent** — PydanticAI and OpenAI SDK with provider abstraction (v0.6.0)
 - [ ] **AI Agent intent** — tool-calling agent scaffold (v0.7.0)
 - [ ] **RAG System intent** — retrieval-augmented generation scaffold (v0.8.0)
 - [ ] **Data Project intent** — analysis, dashboard, ETL, ML sub-options (v0.9.0)

diff --git a/docs/architecture.md b/docs/architecture.md
@@ -23,7 +23,7 @@ Entry point: `spawn.cli.app:main` (defined in `pyproject.toml` as `[project.scri
 
 ```
 src/spawn/
-├── __init__.py         # __version__ via importlib.metadata, fallback "0.5.0"
+├── __init__.py         # __version__ via importlib.metadata, fallback "0.6.0"
 ├── cli/
 │   ├── app.py          # Typer app: create, version, doctor commands
 │   └── prompts.py      # Interactive prompts; derives menu from registry
@@ -50,6 +50,9 @@ src/spawn/
 │   ├── automation/
 │   │   ├── __init__.py       # AutomationTemplate
 │   │   └── content.py        # Workflow, task, logger, test, README content strings
+│   ├── chatbot/
+│   │   ├── __init__.py       # ChatbotTemplate (branches on framework)
+│   │   └── content.py        # LLM provider, chat, prompt, test, README strings
 │   ├── python_script/        # Reserved — not in active menu
 │   ├── data_science/         # Reserved — not in active menu
 │   └── ml_project/           # Reserved — not in active menu
@@ -137,6 +140,7 @@ Each template lives in its own subdirectory with an `__init__.py` (class) and `c
 | `backend-api` | `BackendAPITemplate` | fastapi, flask, django | ruff, pytest, docker, github-actions |
 | `cli` | `CLITemplate` | typer, click, argparse | ruff, pytest, github-actions |
 | `automation` | `AutomationTemplate` | none | ruff, pytest, github-actions |
+| `chatbot` | `ChatbotTemplate` | pydantic-ai, openai-sdk | ruff, pytest, github-actions |
 
 `get_template(slug)` returns a default-constructed instance. `instantiate_template(config)` forwards `framework`, `extras`, and `cli_type` from `ProjectConfig` to templates whose constructors accept them, using signature introspection.
 

diff --git a/docs/changelog.md b/docs/changelog.md
@@ -3,6 +3,41 @@
 All notable changes to Spawn are documented here.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## v0.6.0 — 2026
+
+### New Features
+
+- **AI Chatbot intent** — generates a fully runnable conversational AI project
+  with runtime memory, centralized prompt management, and provider abstraction
+- **3 frameworks**: PydanticAI, OpenAI SDK, LiteLLM
+- **6 providers**: OpenAI, Anthropic, Gemini, OpenRouter, Ollama, Groq
+- **16 supported combinations** — each generates correct dependencies,
+  provider-specific env vars, and working llm.py out of the box
+- **Runtime memory** — `src/memory/history.py` maintains conversation
+  context across turns within a session; no database required
+- **Plain-text prompt system** — `src/prompts/system.txt` is editable
+  without touching Python code; loaded dynamically at runtime
+- **Rich extra** — opt-in `rich` terminal UI with colored panels and
+  styled input/output
+- **Provider-specific env vars** — generated `.env.example` uses the
+  correct key name for each provider (OPENAI_API_KEY, ANTHROPIC_API_KEY,
+  GOOGLE_API_KEY, OPENROUTER_API_KEY, OLLAMA_BASE_URL)
+
+### Bug Fixes
+
+- Fixed `result.data` → `result.output` in PydanticAI provider
+  (AgentRunResult attribute name in current pydantic-ai)
+- Fixed `setdefault("OPENAI_API_KEY")` pattern that silently broke
+  non-OpenAI providers; api_key is now passed directly to run_sync()
+
+### Internal
+
+- `ProjectConfig` gains `provider: str | None = None` field
+- `TemplateMetadata` gains `available_providers: list[str]` field
+- `instantiate_template()` forwards `provider` to template constructors
+- Registry: chatbot updated to 3 frameworks, 5 providers, 4 extras
+- Version bumped to 0.6.0
+
 ## v0.5.0 — 2026
 
 ### New Features

diff --git a/docs/commands.md b/docs/commands.md
@@ -19,7 +19,7 @@ Creates a new project directory from a template, writes starter files, installs
 | Step | Prompt | When shown |
 |---|---|---|
 | 1 | `Project Name` | Always |
-| 2 | Template list → `Choose Template [1-3]` | Always |
+| 2 | Template list → `Choose Template [1-4]` | Always |
 | 3 | CLI Type list → `Choose CLI Type [1-2]` | Only for CLI Application |
 | 4 | Framework list → `Choose Framework [1-N]` | Only for templates with frameworks |
 | 5 | Extras list → `Extras` | Only for templates with extras |
@@ -49,6 +49,7 @@ Templates are displayed as a numbered list. The current registry order:
 | `1` | `backend-api` | Backend API — production-ready FastAPI, Flask, or Django |
 | `2` | `cli` | CLI Application — Typer, Click, or Argparse with Utility or Interactive type |
 | `3` | `automation` | Automation Tool — workflow-based automation with logging and tasks |
+| `4` | `chatbot` | AI Chatbot — PydanticAI or OpenAI SDK with provider abstraction |
 
 **Invalid input error (exact):**
 ```
@@ -361,6 +362,30 @@ uv run python -m src.main
 
 ---
 
+### AI Chatbot intent
+
+Selecting AI Chatbot triggers a framework prompt then extras.
+
+#### Framework selection
+
+```
+  1  pydantic-ai
+  2  openai-sdk
+
+Choose Framework [1-2]:
+```
+
+| Input | Framework | Key dependency |
+|---|---|---|
+| `1` (default) | PydanticAI | `pydantic-ai` |
+| `2` | OpenAI SDK | `openai` |
+
+Both variants install `python-dotenv` and use the same project structure.
+
+Provider switching requires changes only in `src/providers/llm.py` and `.env`.
+
+---
+
 ### `.spawn/meta.json`
 
 Every generated project receives a `.spawn/meta.json` file:
@@ -369,7 +394,7 @@ Every generated project receives a `.spawn/meta.json` file:
 {
   "intent": "backend-api",
   "framework": "fastapi",
-  "spawn_version": "0.5.0"
+  "spawn_version": "0.6.0"
 }
 ```
 
@@ -443,7 +468,7 @@ Prints the installed package version.
 **Output (exact):**
 
 ```
-Spawn v0.5.0
+Spawn v0.6.0
 ```
 
 ---

diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -31,8 +31,9 @@ $ spawn create
   1  Backend API
   2  CLI Application
   3  Automation Tool
+  4  AI Chatbot
 
-Choose Template [1-3]: 2
+Choose Template [1-4]: 2
 
   1  utility
   2  interactive
@@ -81,8 +82,9 @@ $ spawn create
   1  Backend API
   2  CLI Application
   3  Automation Tool
+  4  AI Chatbot
 
-Choose Template [1-3]: 1
+Choose Template [1-4]: 1
 
   1  fastapi
   2  flask
@@ -165,7 +167,7 @@ spawn version
 ```
 
 ```
-Spawn v0.5.0
+Spawn v0.6.0
 ```
 
 ```bash

diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "spawn"
-version = "0.5.0"
+version = "0.6.0"
 description = "Spawn a ready-to-use Python project in seconds"
 readme = "README.md"
 requires-python = ">=3.12"

diff --git a/src/spawn/__init__.py b/src/spawn/__init__.py
@@ -3,4 +3,4 @@
 try:
     __version__ = version("spawn")
 except PackageNotFoundError:
-    __version__ = "0.5.0"
+    __version__ = "0.6.0"
diff --git a/src/spawn/cli/prompts.py b/src/spawn/cli/prompts.py
@@ -5,6 +5,7 @@
 from spawn.utils.console import console
 from spawn.core.models import ProjectConfig
 from spawn.core.registry import list_templates, get_metadata
+from spawn.templates.chatbot import get_supported_providers
 from spawn.utils.validators import validate_project_name
 from spawn.core.exceptions import SpawnError
 
@@ -69,6 +70,7 @@ def get_project_config() -> ProjectConfig:
     # --- Framework selection ---
     selected_framework: str | None = None
     selected_cli_type: str | None = None
+    selected_provider: str | None = None
     meta = get_metadata(template)
 
     # --- CLI type selection ---
@@ -130,6 +132,43 @@ def get_project_config() -> ProjectConfig:
 
         selected_framework = framework_map[fw_choice]
 
+    # --- Provider selection ---
+    if meta and meta.available_providers and selected_framework:
+        provider_options = (
+            get_supported_providers(selected_framework)
+            if selected_framework
+            else meta.available_providers
+        )
+        provider_choice_map = {
+            str(i): p for i, p in enumerate(provider_options, start=1)
+        }
+
+        _print_list(provider_options)
+
+        valid_prov_range = len(provider_options)
+        prov_choice = typer.prompt(
+            typer.style(
+                f"Choose Provider [1-{valid_prov_range}]",
+                fg=typer.colors.CYAN,
+            ),
+            default="1",
+        )
+
+        while prov_choice not in provider_choice_map:
+            typer.secho(
+                "Invalid choice. Please select a valid number.",
+                fg=typer.colors.RED,
+            )
+            prov_choice = typer.prompt(
+                typer.style(
+                    f"Choose Provider [1-{valid_prov_range}]",
+                    fg=typer.colors.CYAN,
+                ),
+                default="1",
+            )
+
+        selected_provider = provider_choice_map[prov_choice]
+
     # --- Extras selection ---
     selected_extras: list[str] = []
 
@@ -175,4 +214,5 @@ def get_project_config() -> ProjectConfig:
         framework=selected_framework,
         extras=selected_extras,
         cli_type=selected_cli_type,
+        provider=selected_provider,
     )
diff --git a/src/spawn/core/models.py b/src/spawn/core/models.py
@@ -9,3 +9,4 @@ class ProjectConfig:
     framework: str | None = None
     extras: list[str] = field(default_factory=list)
     cli_type: str | None = None
+    provider: str | None = None
diff --git a/src/spawn/core/registry.py b/src/spawn/core/registry.py
@@ -9,6 +9,7 @@
 from spawn.templates.backend_api import BackendAPITemplate
 from spawn.templates.cli_application import CLITemplate
 from spawn.templates.automation import AutomationTemplate
+from spawn.templates.chatbot import ChatbotTemplate
 from spawn.templates.base import BaseTemplate
 
 
@@ -21,6 +22,7 @@ class TemplateMetadata:
     available_frameworks: list[str] = field(default_factory=list)
     available_extras: list[str] = field(default_factory=list)
     available_cli_types: list[str] = field(default_factory=list)
+    available_providers: list[str] = field(default_factory=list)
 
 
 # Slugs that existed in previous versions but have been superseded.
@@ -53,6 +55,15 @@ class TemplateMetadata:
         template_class=AutomationTemplate,
         available_extras=["ruff", "pytest", "github-actions"],
     ),
+    "chatbot": TemplateMetadata(
+        slug="chatbot",
+        display_name="AI Chatbot",
+        description="Conversational AI with PydanticAI, OpenAI SDK, or LiteLLM",
+        template_class=ChatbotTemplate,
+        available_frameworks=["pydantic-ai", "openai-sdk", "litellm"],
+        available_providers=["openai", "anthropic", "gemini", "openrouter", "ollama", "groq"],
+        available_extras=["ruff", "pytest", "rich", "github-actions"],
+    ),
 }
 
 
@@ -93,6 +104,8 @@ def instantiate_template(config: ProjectConfig) -> BaseTemplate | None:
         kwargs["extras"] = config.extras
     if "cli_type" in params:
         kwargs["cli_type"] = config.cli_type
+    if "provider" in params:
+        kwargs["provider"] = config.provider
 
     return cls(**kwargs)
 

diff --git a/src/spawn/generators/project_generator.py b/src/spawn/generators/project_generator.py
@@ -76,6 +76,7 @@ def generate(self, config: ProjectConfig) -> Path:
                     {
                         "intent": config.template,
                         "framework": config.framework,
+                        "provider": config.provider,
                         "spawn_version": __version__,
                     },
                     indent=2,