appgenerator-cli 1.0.0__py3-none-any.whl

appgenerator_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,213 @@
+Metadata-Version: 2.3
+Name: appgenerator-cli
+Version: 1.0.0
+Summary: A developer-friendly scaffolding CLI for FastAPI and LangChain/LangGraph projects
+Keywords: cli,scaffolding,fastapi,langchain,langgraph,uv
+Author: Rajendra Kumar Yadav
+Author-email: Rajendra Kumar Yadav <yadavrajendrakumar@outlook.com>
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/rajendrakumaryadav/pyforge
+Project-URL: Repository, https://github.com/rajendrakumaryadav/pyforge
+Project-URL: Issues, https://github.com/rajendrakumaryadav/pyforge/issues
+Description-Content-Type: text/markdown
+
+# ⚒ AppGenerator CLI
+
+> Scaffold production-ready Python projects in seconds — powered by `uv`.
+
+```
+$ appgenerator create fastapi my_api
+$ appgenerator create ai my_ai_app --docker --postgres
+```
+
+---
+
+## Installation
+
+```bash
+pip install appgenerator-cli
+# or, with uv (recommended):
+uv tool install appgenerator-cli
+```
+
+Verify:
+```bash
+appgenerator --version
+```
+
+---
+
+## Commands
+
+### `appgenerator create fastapi <name>`
+
+Scaffold a **FastAPI** backend.
+
+| Flag | Description |
+|------|-------------|
+| `--docker` | Add `Dockerfile` + `docker-compose.yml` |
+| `--postgres` | Use PostgreSQL (`asyncpg`) instead of SQLite |
+| `--redis` | Add Redis client (`redis`) |
+| `--output PATH` | Create the project in a custom directory |
+
+**Example:**
+```bash
+appgenerator create fastapi my_api --docker --postgres --redis
+cd my_api
+cp .env.example .env
+uv run uvicorn app.main:app --reload
+```
+
+### `appgenerator create ai <name>`
+
+Scaffold a **LangChain / LangGraph** AI application.
+
+| Flag | Description |
+|------|-------------|
+| `--docker` | Add `Dockerfile` + `docker-compose.yml` |
+| `--postgres` | Add pgvector PostgreSQL support |
+| `--redis` | Add Redis semantic cache |
+| `--output PATH` | Create the project in a custom directory |
+
+**Example:**
+```bash
+appgenerator create ai my_assistant --docker
+cd my_assistant
+cp .env.example .env   # add your OPENAI_API_KEY
+uv run python main.py
+```
+
+---
+
+## Generated Project Structure
+
+### FastAPI
+
+```
+my_api/
+├── app/
+│   ├── main.py          # Application factory
+│   ├── config.py        # Pydantic Settings
+│   ├── dependencies.py  # FastAPI deps (DB session, etc.)
+│   ├── api/v1/
+│   │   └── health.py    # Health-check endpoint
+│   ├── models/
+│   │   └── base.py      # SQLModel base with timestamps
+│   └── db/
+│       └── session.py   # Async session factory
+├── tests/
+│   ├── conftest.py      # Async test client + DB fixtures
+│   └── test_health.py
+├── .env.example
+├── .gitignore
+├── pyproject.toml
+├── Dockerfile           # (--docker)
+└── docker-compose.yml   # (--docker)
+```
+
+### AI (LangChain / LangGraph)
+
+```
+my_assistant/
+├── main.py              # Interactive REPL
+├── app/
+│   ├── config.py        # Pydantic Settings
+│   ├── agents/
+│   │   └── assistant.py # LangGraph ReAct agent
+│   ├── chains/
+│   │   └── rag.py       # RAG chain example
+│   └── tools/
+│       ├── registry.py  # Tool registry
+│       └── search.py    # Web search tool stub
+├── tests/
+│   └── test_agent.py
+├── .env.example
+├── .gitignore
+├── pyproject.toml
+├── Dockerfile           # (--docker)
+└── docker-compose.yml   # (--docker)
+```
+
+---
+
+## Packaging & Publishing to PyPI
+
+### 1. Build
+
+```bash
+# Install build tools
+pip install build twine
+
+# Build wheel + sdist
+python -m build
+# Outputs: dist/appgenerator_cli-0.1.0-py3-none-any.whl
+#          dist/appgenerator_cli-0.1.0.tar.gz
+```
+
+### 2. Test on TestPyPI
+
+```bash
+twine upload --repository testpypi dist/*
+pip install --index-url https://test.pypi.org/simple/ appgenerator-cli
+```
+
+### 3. Publish to PyPI
+
+```bash
+twine upload dist/*
+```
+
+Or with uv:
+
+```bash
+uv build
+uv publish
+```
+
+---
+
+## Development Setup
+
+```bash
+git clone https://github.com/yourname/pyforge-cli
+cd pyforge-cli
+
+uv venv
+uv sync --dev
+
+# Run locally
+uv run appgenerator --help
+
+# Tests
+uv run pytest
+
+# Lint
+uv run ruff check .
+uv run ruff format .
+```
+
+---
+
+## Requirements
+
+- Python ≥ 3.10
+- [`uv`](https://docs.astral.sh/uv/) installed on the system (for generated project env management)
+
+---
+
+## License
+
+MIT

appgenerator_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,48 @@
+pyforge/__init__.py,sha256=8izMloJRT3IJTWLHt4DPnRnF_HBWNa4kCeptw8ixZ4g,229
+pyforge/commands/__init__.py,sha256=gQ6tnU0Rvm0-ESWFUBU-KDl5dpNOpUTG509hXOQQjwY,27
+pyforge/commands/create.py,sha256=0uLonhz2kJ5f33_kC9Tf8ogsVMCn41gopRxWOS4SSFc,2233
+pyforge/generator.py,sha256=vXlZqNfU6ar-9t_C0ip-9NODP39Y0FDbVl34ilFh0UM,8620
+pyforge/main.py,sha256=6pU8tYJayiVnMBTE8yvwoln2AxhIN5R3glq2YyG1AhY,875
+pyforge/templates/ai/.env.example,sha256=dhiwWIbwCpXRetrAHBswJZchhlW0c6Lm8FBPv-5iEpk,1332
+pyforge/templates/ai/.gitignore,sha256=d37AN_cpkr6IYCoQhvWkP1g5-352Z5FxT0qsQVn_sro,399
+pyforge/templates/ai/Dockerfile,sha256=X5_IlCm9oP9XrqCOD69WkXdx6LiDu-Itls17Im6uDP0,786
+pyforge/templates/ai/README.md,sha256=6c39K6kt_2hbCBespsRLHqkUVSrn9kPC_j1u4wSBYVQ,2748
+pyforge/templates/ai/app/__init__.py,sha256=NhaPqUY6LTjOiB6li75lrY01m3Maf77e-TrB610URA4,49
+pyforge/templates/ai/app/agents/__init__.py,sha256=K3TLCPOIwxTcWpYR-rmP-QPJWdb5_wnMW5B1Wr68trs,25
+pyforge/templates/ai/app/agents/assistant.py,sha256=Wi_X_CifyGtgJaAZ8ZqgOqEbDt7fQKUwcu0hDcdKHtQ,3655
+pyforge/templates/ai/app/chains/__init__.py,sha256=gPLZRZ2MLXBiafF_riw6Wgo07yn_rjugUK1Bq8eZyqQ,44
+pyforge/templates/ai/app/chains/rag.py,sha256=RrLT2DTNfSuP5tqnOSBlC3-33oZY6sdb8aKLprPrDxU,1383
+pyforge/templates/ai/app/config.py,sha256=Co6_eaaWpaUq4siqm6LoETX5Np4tGrI2FAYuHHvbDzk,1088
+pyforge/templates/ai/app/tools/__init__.py,sha256=ffZt2FB3NFrHjbvROCGyorUYdJHu-yzmi17E0sacXtQ,30
+pyforge/templates/ai/app/tools/registry.py,sha256=iMYxWm2DNk7NnhV0Ng0ACVs4pyf6iIiLvxdQmorqMww,455
+pyforge/templates/ai/app/tools/search.py,sha256=q4nGmVIR3dlVGxnASHx6YHJZZ2WduyCAm5aNjt6gvyE,1327
+pyforge/templates/ai/docker-compose.yml,sha256=zAp94_ssKr21Ckm5Ai6-JcOhWZBg0Zi2vF-IES403Do,776
+pyforge/templates/ai/main.py,sha256=3JtvWH3p8ZjfduMf5WED2L5jR7416bch0z8h3-sRG9s,948
+pyforge/templates/ai/pyproject.toml,sha256=cGIXwjkq4W-ov22DzbM6LldP6KC-lg2nLo2OkGd05xI,543
+pyforge/templates/ai/tests/__init__.py,sha256=j-x4uousrt8rA7mrJ8pNKAc_38kKUMrU8I7gvI1ylG0,41
+pyforge/templates/ai/tests/conftest.py,sha256=YNMpVpX3-kolFtxcpW-1wep2ehtj6FXp5DS1hjSIS2k,625
+pyforge/templates/ai/tests/test_agent.py,sha256=INDRb-XwMWSZOzK0ej3i2KwkDGIr5yZzD1ty565tMec,1762
+pyforge/templates/fastapi/.env.example,sha256=6Iv7Opys57RpWdeYuZQOnleXG3n-MaY79gAON7o8Vjs,1092
+pyforge/templates/fastapi/.gitignore,sha256=WWUEaHQnwHKCefTYooPgdDGJScKWIxlqFvBOVrvPdbE,307
+pyforge/templates/fastapi/Dockerfile,sha256=4gk2LYeRHaU9LUL7RbOpbIYv2RiHPih7xYjuUZB-70c,923
+pyforge/templates/fastapi/README.md,sha256=24i60XTJQ86edN6Ey_QfHueWiaW2FHjmOEjuqsyzVeg,1931
+pyforge/templates/fastapi/app/__init__.py,sha256=WwDGHlbBHaUL99XtoQhbvGhV_O7EaCE6nCikhkk9cvs,46
+pyforge/templates/fastapi/app/api/__init__.py,sha256=d7XMEse6wwtLORqrQmnhaKMI8KM3lJSzRVE7HVskq1w,19
+pyforge/templates/fastapi/app/api/v1/__init__.py,sha256=TSD_55lofQDrklwHqqm_zlDAL695k0RTThXsgIDDqDY,22
+pyforge/templates/fastapi/app/api/v1/health.py,sha256=WFkYMNXEs-RL76gF1j7tT8PQyzDRCLQn7b8tOTdCxsg,575
+pyforge/templates/fastapi/app/config.py,sha256=nAGQZG5C9pKl8OO1UJ054oE1MwHNgJCd1_fkQxluUNc,1120
+pyforge/templates/fastapi/app/db/__init__.py,sha256=-izZUgEShtb52VcDe78h2-xPG0Im1WDkKVHy8dMfg78,24
+pyforge/templates/fastapi/app/db/session.py,sha256=XK8ekpRmF_S46Dgj2SK2gkYSyt9ibNu_8Nkee_CRoEU,968
+pyforge/templates/fastapi/app/dependencies.py,sha256=U_wGGNnyYqbdBUevC9CHATHxMtJ6oIqxyRZyk54KlNg,362
+pyforge/templates/fastapi/app/main.py,sha256=dfLQSZriNVao5w1L__VtlsWlznnj5Mts7tH1VnuAsBs,1378
+pyforge/templates/fastapi/app/models/__init__.py,sha256=YNPfDtvd2_5O_4RfPf67FGHivfhpASepWeC9W-jut3M,127
+pyforge/templates/fastapi/app/models/base.py,sha256=R6_YyZXhSMKCpum5Ago2pHduIJB6vQhiHLtRH8TU8AQ,637
+pyforge/templates/fastapi/docker-compose.yml,sha256=fujLVY_QxzEV_ZHEpu5GAurO9SyIl0UfDORDtdn5rMQ,713
+pyforge/templates/fastapi/pyproject.toml,sha256=sNce628pZlgSTuTCRHDcUAFqwCMG6T_xcDKgpNSLlC4,531
+pyforge/templates/fastapi/tests/__init__.py,sha256=TiS6C1IzwAXmNa8u36Y2xzL1CTTZm2PwzAtmZgoqepE,18
+pyforge/templates/fastapi/tests/conftest.py,sha256=8I69eLCzAtA5tlZ4m94ktxcUOnCs7uehBnd2odWXe98,1312
+pyforge/templates/fastapi/tests/test_health.py,sha256=EEw9GEVlCoHv7BVTx2dZMOfot_73g_5orD8cHUjJL54,375
+appgenerator_cli-1.0.0.dist-info/WHEEL,sha256=M4DeIjVCA49okfALADZoWX5JOGwnmHb-JOpQHtI-1c0,80
+appgenerator_cli-1.0.0.dist-info/entry_points.txt,sha256=5bQ5Wcg5NqyyvTzJ0fZy8zO41FCKvABQ72ObGrSIW-o,78
+appgenerator_cli-1.0.0.dist-info/METADATA,sha256=mZx_QnK8ZWjGnjRSzfmHPfEJhXWV57aP7R9dlHsyBwc,4882
+appgenerator_cli-1.0.0.dist-info/RECORD,,

appgenerator_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.2
+Root-Is-Purelib: true
+Tag: py3-none-any

appgenerator_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+appgenerator = pyforge.main:app
+pyforge = pyforge.main:app
+

pyforge/__init__.py

@@ -0,0 +1,10 @@
+"""PyForge CLI package."""
+
+from importlib.metadata import metadata
+
+try:
+	_meta = metadata("appgenerator-cli")
+except Exception:
+	_meta = metadata("pyforge-cli")
+__version__ = _meta["Version"]
+__author__ = _meta["Author-email"]

pyforge/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI command modules."""

pyforge/commands/create.py

@@ -0,0 +1,60 @@
+"""
+`appgenerator create` subcommand group.
+Delegates to template-specific generators.
+"""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+
+from pyforge.generator import ProjectGenerator
+
+create_app = typer.Typer(no_args_is_help=True, rich_markup_mode="rich")
+console = Console()
+
+
+def _run_generator(
+    template: str,
+    project_name: str,
+    output_dir: Optional[Path],
+    docker: bool,
+    postgres: bool,
+    redis: bool,
+) -> None:
+    target = (output_dir or Path.cwd()) / project_name
+    if target.exists():
+        console.print(f"[bold red]✗[/] Directory [bold]{target}[/] already exists.")
+        raise typer.Exit(code=1)
+
+    generator = ProjectGenerator(
+        template=template,
+        project_name=project_name,
+        target_dir=target,
+        options={"docker": docker, "postgres": postgres, "redis": redis},
+    )
+    generator.run()
+
+
+@create_app.command("fastapi", help="Scaffold a [bold]FastAPI[/] backend project.")
+def create_fastapi(
+    project_name: str = typer.Argument(..., help="Name of the new project."),
+    output_dir: Optional[Path] = typer.Option(None, "--output", "-o", help="Parent directory."),
+    docker: bool = typer.Option(False, "--docker", help="Add Dockerfile & docker-compose.yml."),
+    postgres: bool = typer.Option(False, "--postgres", help="Add PostgreSQL support."),
+    redis: bool = typer.Option(False, "--redis", help="Add Redis support."),
+) -> None:
+    _run_generator("fastapi", project_name, output_dir, docker, postgres, redis)
+
+
+@create_app.command("ai", help="Scaffold a [bold]LangChain / LangGraph[/] AI project.")
+def create_ai(
+    project_name: str = typer.Argument(..., help="Name of the new project."),
+    output_dir: Optional[Path] = typer.Option(None, "--output", "-o", help="Parent directory."),
+    docker: bool = typer.Option(False, "--docker", help="Add Dockerfile & docker-compose.yml."),
+    postgres: bool = typer.Option(False, "--postgres", help="Add PostgreSQL vector DB support."),
+    redis: bool = typer.Option(False, "--redis", help="Add Redis cache support."),
+) -> None:
+    _run_generator("ai", project_name, output_dir, docker, postgres, redis)

pyforge/generator.py

@@ -0,0 +1,248 @@
+"""
+Core project generation engine.
+Handles file rendering, uv init, and dependency installation.
+"""
+from __future__ import annotations
+
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+from typing import Any
+
+from jinja2 import Environment, FileSystemLoader
+from rich.console import Console
+from rich.panel import Panel
+from rich.progress import Progress, SpinnerColumn, TextColumn
+from rich.table import Table
+
+console = Console()
+
+# Package root — templates live here
+TEMPLATES_DIR = Path(__file__).parent / "templates"
+
+
+class ProjectGenerator:
+    """Renders a project template and initialises it with uv."""
+
+    FASTAPI_DEPS = [
+        "fastapi",
+        "uvicorn[standard]",
+        "sqlmodel",
+        "aiosqlite",
+        "pydantic",
+        "pydantic-settings",
+        "python-dotenv",
+        "alembic",
+        "httpx",
+    ]
+    FASTAPI_DEV_DEPS = ["pytest", "pytest-asyncio", "httpx", "ruff", "mypy"]
+
+    AI_DEPS = [
+        "langchain",
+        "langgraph",
+        "langchain-community",
+        "langchain-openai",
+        "langchain-ollama",
+        "langchain-chroma",
+        "chromadb",
+        "openai",
+        "tiktoken",
+        "python-dotenv",
+        "pydantic",
+        "pydantic-settings",
+        "httpx",
+    ]
+    AI_DEV_DEPS = ["pytest", "pytest-asyncio", "ruff", "mypy"]
+
+    OPTIONAL_DEPS: dict[str, list[str]] = {
+        "postgres": ["asyncpg", "psycopg2-binary"],
+        "redis": ["redis", "hiredis"],
+    }
+
+    def __init__(
+        self,
+        template: str,
+        project_name: str,
+        target_dir: Path,
+        options: dict[str, Any],
+    ) -> None:
+        self.template = template  # "fastapi" | "ai"
+        self.project_name = project_name
+        self.target_dir = target_dir
+        self.options = options
+        self.template_dir = TEMPLATES_DIR / template
+        self.env = Environment(
+            loader=FileSystemLoader(str(self.template_dir)),
+            keep_trailing_newline=True,
+        )
+
+    # ------------------------------------------------------------------ #
+    #  Public API
+    # ------------------------------------------------------------------ #
+
+    def run(self) -> None:
+        console.print()
+        console.print(
+            Panel.fit(
+                f"[bold cyan]⚒  AppGenerator[/]  ·  Creating [bold]{self.project_name}[/] "
+                f"([italic]{self.template}[/] template)",
+                border_style="cyan",
+            )
+        )
+        console.print()
+
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[progress.description]{task.description}"),
+            console=console,
+            transient=True,
+        ) as progress:
+            t = progress.add_task("Rendering template files …", total=None)
+            self._render_template()
+            progress.update(t, description="[green]✓[/] Template files written")
+
+            progress.update(t, description="Initialising uv project …", completed=None)
+            self._uv_init()
+            progress.update(t, description="[green]✓[/] uv project initialised")
+
+            progress.update(t, description="Installing dependencies …", completed=None)
+            self._install_deps()
+            progress.update(t, description="[green]✓[/] Dependencies installed")
+
+        self._print_success()
+
+    # ------------------------------------------------------------------ #
+    #  Steps
+    # ------------------------------------------------------------------ #
+
+    def _render_template(self) -> None:
+        """Walk the template directory, render Jinja files, copy static files."""
+        ctx = self._build_context()
+
+        for src in self.template_dir.rglob("*"):
+            if src.is_dir():
+                continue
+
+            rel = src.relative_to(self.template_dir)
+            dest = self.target_dir / rel
+
+            # Skip optional files based on flags
+            if self._should_skip(rel):
+                continue
+
+            dest.parent.mkdir(parents=True, exist_ok=True)
+
+            if src.suffix in {".py", ".toml", ".env", ".yml", ".yaml", ".md", ".txt", ".cfg", ".ini", ".dockerfile", ""} or src.name == ".env.example":
+                try:
+                    template = self.env.get_template(str(rel).replace("\\", "/"))
+                    dest.write_text(template.render(**ctx), encoding="utf-8")
+                except Exception:
+                    # Binary or unparseable — just copy
+                    shutil.copy2(src, dest)
+            else:
+                shutil.copy2(src, dest)
+
+    def _uv_init(self) -> None:
+        """Run `uv init` inside the target directory (no-op if uv not found)."""
+        if not shutil.which("uv"):
+            console.print(
+                "[yellow]⚠[/]  [bold]uv[/] not found — skipping venv initialisation. "
+                "Install uv: [link=https://docs.astral.sh/uv/]https://docs.astral.sh/uv/[/link]"
+            )
+            return
+
+        # uv init creates a pyproject.toml — we already created ours, so just create the venv
+        self._run(["uv", "venv"], cwd=self.target_dir)
+
+    def _install_deps(self) -> None:
+        """Write dependencies into pyproject.toml and sync the venv.
+
+        Uses --no-sync on `uv add` so uv only updates pyproject.toml + uv.lock
+        without trying to build/install the generated project itself as an
+        editable package.
+
+        The actual installation is done by a follow-up
+        `uv sync --no-install-project`.
+        """
+        if not shutil.which("uv"):
+            return
+
+        deps = self.FASTAPI_DEPS if self.template == "fastapi" else self.AI_DEPS
+        dev_deps = self.FASTAPI_DEV_DEPS if self.template == "fastapi" else self.AI_DEV_DEPS
+
+        for flag, pkgs in self.OPTIONAL_DEPS.items():
+            if self.options.get(flag):
+                deps = deps + pkgs
+
+        # --no-sync: only pin versions into pyproject.toml / uv.lock, don't build project
+        self._run(["uv", "add", "--no-sync"] + deps, cwd=self.target_dir)
+        self._run(["uv", "add", "--no-sync", "--dev"] + dev_deps, cwd=self.target_dir)
+
+        # Install all pinned deps into .venv, skipping the project root package
+        self._run(["uv", "sync", "--no-install-project"], cwd=self.target_dir)
+
+    # ------------------------------------------------------------------ #
+    #  Helpers
+    # ------------------------------------------------------------------ #
+
+    def _build_context(self) -> dict[str, Any]:
+        pkg = self.project_name.lower().replace("-", "_").replace(" ", "_")
+        return {
+            "project_name": self.project_name,
+            "package_name": pkg,
+            "template": self.template,
+            "docker": self.options.get("docker", False),
+            "postgres": self.options.get("postgres", False),
+            "redis": self.options.get("redis", False),
+            "fastapi_deps": self.FASTAPI_DEPS,
+            "ai_deps": self.AI_DEPS,
+        }
+
+    def _should_skip(self, rel: Path) -> bool:
+        name = rel.name
+        parts = set(rel.parts)
+        if name in {"Dockerfile", "docker-compose.yml"} and not self.options.get("docker"):
+            return True
+        if "postgres" in parts and not self.options.get("postgres"):
+            return True
+        if "redis" in parts and not self.options.get("redis"):
+            return True
+        return False
+
+    def _run(self, cmd: list[str], cwd: Path) -> None:
+        result = subprocess.run(
+            cmd,
+            cwd=cwd,
+            capture_output=True,
+            text=True,
+        )
+        if result.returncode != 0:
+            console.print(f"[red]Command failed:[/] {' '.join(cmd)}")
+            console.print(result.stderr)
+            sys.exit(result.returncode)
+
+    def _print_success(self) -> None:
+        table = Table.grid(padding=(0, 2))
+        table.add_column(style="bold green")
+        table.add_column()
+
+        rel = self.target_dir.resolve()
+        run_cmd = (
+            "uvicorn app.main:app --reload"
+            if self.template == "fastapi"
+            else "python main.py"
+        )
+
+        table.add_row("Project:", str(rel))
+        table.add_row("Template:", self.template)
+        table.add_row("venv:", str(rel / ".venv"))
+        table.add_row("", "")
+        table.add_row("Next steps:", f"cd {self.project_name}")
+        table.add_row("", "cp .env.example .env  # fill in your secrets")
+        table.add_row("", f"uv run {run_cmd}")
+
+        console.print(
+            Panel(table, title="[bold green]✓  Project created[/]", border_style="green")
+        )
+        console.print()

pyforge/main.py

@@ -0,0 +1,32 @@
+"""
+AppGenerator CLI — A scaffolding tool for FastAPI and LangChain/LangGraph projects.
+"""
+import typer
+from rich.console import Console
+
+from pyforge.commands.create import create_app
+
+app = typer.Typer(
+    name="appgenerator",
+    help="⚒️  AppGenerator — Scaffold production-ready Python projects instantly.",
+    no_args_is_help=True,
+    rich_markup_mode="rich",
+)
+console = Console()
+
+app.add_typer(create_app, name="create", help="Create a new project from a template.")
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    version: bool = typer.Option(False, "--version", "-v", help="Show version and exit."),
+) -> None:
+    if version:
+        from pyforge import __version__
+        console.print(f"[bold cyan]AppGenerator[/] version [bold]{__version__}[/]")
+        raise typer.Exit()
+
+
+if __name__ == "__main__":
+    app()

pyforge/templates/ai/.env.example

@@ -0,0 +1,29 @@
+# ── LLM Providers ────────────────────────────────────────────
+OPENAI_API_KEY=sk-...
+OPENAI_MODEL=gpt-4o-mini
+
+# Ollama (local models) — optional
+OLLAMA_BASE_URL=http://localhost:11434
+OLLAMA_MODEL=llama3.2
+
+# ── Application ──────────────────────────────────────────────
+APP_NAME="{{ project_name }}"
+APP_ENV=development
+DEBUG=true
+
+# ── Vector Store ──────────────────────────────────────────────
+CHROMA_PERSIST_DIR=./chroma_db
+{% if postgres %}
+# pgvector (PostgreSQL) — enable with --postgres
+PGVECTOR_URL=postgresql://postgres:postgres@localhost:5432/{{ package_name }}_vectors
+{% endif %}
+
+{% if redis %}
+# ── Redis Cache ───────────────────────────────────────────────
+REDIS_URL=redis://localhost:6379/0
+{% endif %}
+
+# ── LangSmith (optional tracing) ─────────────────────────────
+# LANGCHAIN_TRACING_V2=true
+# LANGCHAIN_API_KEY=ls__...
+# LANGCHAIN_PROJECT={{ project_name }}