@totaland/create-starter-kit 2.0.4 → 2.0.5

package/bin/index.js

@@ -21,7 +21,7 @@ const templateArg = process.argv[3]; // Optional template argument
 if (!projectName) {
     console.error('Error: Please provide a project name');
     console.log('Usage: pnpm create @totaland/starter-kit <project-name> [template]');
-    console.log('Templates: backend, frontend, fullstack');
+    console.log('Templates: backend, frontend, fullstack, python-backend, ai-fullstack');
     process.exit(1);
 }
 
@@ -47,11 +47,23 @@ const TEMPLATES = {
         description: 'React + Vite with TypeScript, Tailwind CSS v4, shadcn/ui, and TanStack Query',
         dir: 'frontend',
     },
+    'python-backend': {
+        name: 'Python AI Backend',
+        description: 'FastAPI + LangGraph + OpenAI/Anthropic for AI orchestration',
+        dir: 'python-backend',
+        isPython: true,
+    },
     fullstack: {
         name: 'Fullstack',
         description: 'Both Backend and Frontend templates combined',
         dirs: ['backend', 'frontend'],
     },
+    'ai-fullstack': {
+        name: 'AI Fullstack',
+        description: 'Python AI Backend + React Frontend',
+        dirs: ['python-backend', 'frontend'],
+        isPython: true,
+    },
 };
 
 // Directories and files to exclude when copying
@@ -69,6 +81,14 @@ const EXCLUDE = new Set([
     '.env',
     '.env.local',
     '.DS_Store',
+    // Python exclusions
+    '__pycache__',
+    '.venv',
+    'venv',
+    '.pytest_cache',
+    '.mypy_cache',
+    '.ruff_cache',
+    '.eggs',
 ]);
 
 // Function to recursively copy directory
@@ -102,22 +122,32 @@ async function promptTemplate() {
     });
 
     console.log('\n📦 Select a template:\n');
-    console.log('1. Backend   - Express.js + TypeScript + Drizzle ORM');
-    console.log('2. Frontend  - React + Vite + Tailwind CSS v4 + shadcn/ui');
-    console.log('3. Fullstack - Both Backend and Frontend\n');
+    console.log('1. Backend        - Express.js + TypeScript + Drizzle ORM');
+    console.log('2. Frontend       - React + Vite + Tailwind CSS v4 + shadcn/ui');
+    console.log('3. Fullstack      - Backend + Frontend');
+    console.log('4. Python Backend - FastAPI + LangGraph + OpenAI/Anthropic (AI)');
+    console.log('5. AI Fullstack   - Python Backend + Frontend\n');
 
-    const answer = await rl.question('Enter your choice (1, 2, or 3): ');
+    const answer = await rl.question('Enter your choice (1-5): ');
     rl.close();
 
-    if (answer === '1' || answer.toLowerCase() === 'backend') {
-        return 'backend';
-    }
-    if (answer === '2' || answer.toLowerCase() === 'frontend') {
-        return 'frontend';
-    }
-    if (answer === '3' || answer.toLowerCase() === 'fullstack') {
-        return 'fullstack';
-    }
+    const choices = {
+        '1': 'backend',
+        'backend': 'backend',
+        '2': 'frontend',
+        'frontend': 'frontend',
+        '3': 'fullstack',
+        'fullstack': 'fullstack',
+        '4': 'python-backend',
+        'python-backend': 'python-backend',
+        'python': 'python-backend',
+        '5': 'ai-fullstack',
+        'ai-fullstack': 'ai-fullstack',
+        'ai': 'ai-fullstack',
+    };
+
+    const choice = choices[answer.toLowerCase()];
+    if (choice) return choice;
 
     console.error('Invalid choice. Please run the command again.');
     process.exit(1);
@@ -187,19 +217,34 @@ async function main() {
         console.log('✅ Project created successfully!\n');
         console.log('📝 Next steps:');
         console.log(`   cd ${projectName}`);
+        
         if (templateKey === 'fullstack') {
             console.log('   cd backend && pnpm install && pnpm dev');
             console.log('   cd frontend && pnpm install && pnpm dev\n');
+        } else if (templateKey === 'ai-fullstack') {
+            console.log('   cd python-backend && pip install -e ".[dev]" && uvicorn src.main:app --reload');
+            console.log('   cd frontend && pnpm install && pnpm dev\n');
+        } else if (template.isPython) {
+            console.log('   python -m venv .venv && source .venv/bin/activate');
+            console.log('   pip install -e ".[dev]"');
+            console.log('   cp .env.example .env  # Add your API keys');
+            console.log('   uvicorn src.main:app --reload\n');
         } else {
             console.log('   pnpm install');
             console.log('   pnpm dev\n');
         }
 
-        if (templateKey === 'frontend' || templateKey === 'fullstack') {
+        if (templateKey === 'frontend' || templateKey === 'fullstack' || templateKey === 'ai-fullstack') {
             console.log('💡 Tip: Add shadcn/ui components with:');
-            const cdPath = templateKey === 'fullstack' ? 'cd frontend && ' : '';
+            const cdPath = (templateKey === 'fullstack' || templateKey === 'ai-fullstack') ? 'cd frontend && ' : '';
             console.log(`   ${cdPath}pnpm dlx shadcn@latest add button card dialog\n`);
         }
+
+        if (template.isPython) {
+            console.log('🤖 AI Setup: Add your API keys to .env:');
+            console.log('   OPENAI_API_KEY=sk-...');
+            console.log('   ANTHROPIC_API_KEY=sk-ant-...\n');
+        }
     } catch (error) {
         console.error('Error creating project:', error.message);
         process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@totaland/create-starter-kit",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "description": "Scaffolding tool for creating new starter-kit projects",
   "type": "module",
   "publishConfig": {
@@ -13,10 +13,6 @@
     "bin",
     "templates"
   ],
-  "scripts": {
-    "sync-templates": "node scripts/sync-templates.js",
-    "prepublishOnly": "node scripts/sync-templates.js"
-  },
   "keywords": [
     "starter-kit",
     "scaffold",
@@ -24,5 +20,8 @@
   ],
   "dependencies": {
     "fast-glob": "^3.3.2"
+  },
+  "scripts": {
+    "sync-templates": "node scripts/sync-templates.js"
   }
-}
+}

package/templates/python-backend/.env.example

@@ -0,0 +1,36 @@
+APP_NAME="AI Starter Kit"
+DEBUG=true
+
+# Database
+DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/app
+
+# Redis
+REDIS_URL=redis://localhost:6379
+
+# Server
+HOST=0.0.0.0
+PORT=8000
+
+# ===== AI / LLM Configuration =====
+
+# OpenAI - https://platform.openai.com/api-keys
+OPENAI_API_KEY=sk-...
+OPENAI_MODEL=gpt-4o
+OPENAI_EMBEDDING_MODEL=text-embedding-3-small
+
+# Anthropic - https://console.anthropic.com/settings/keys
+ANTHROPIC_API_KEY=sk-ant-...
+ANTHROPIC_MODEL=claude-sonnet-4-20250514
+
+# Default LLM provider: "openai" or "anthropic"
+DEFAULT_LLM_PROVIDER=openai
+
+# LangSmith (optional) - https://smith.langchain.com/
+LANGSMITH_API_KEY=lsv2_...
+LANGSMITH_PROJECT=ai-starter-kit
+LANGSMITH_TRACING=false
+
+# LLM Settings
+LLM_TEMPERATURE=0.7
+LLM_MAX_TOKENS=4096
+LLM_STREAMING=true

package/templates/python-backend/Makefile

@@ -0,0 +1,26 @@
+.PHONY: install dev test lint format typecheck clean
+
+install:
+	pip install -e ".[dev]"
+
+dev:
+	uvicorn src.main:app --reload --host 0.0.0.0 --port 8000
+
+test:
+	pytest
+
+test-cov:
+	pytest --cov=src --cov-report=html
+
+lint:
+	ruff check src tests
+
+format:
+	ruff format src tests
+
+typecheck:
+	mypy src
+
+clean:
+	rm -rf __pycache__ .pytest_cache .mypy_cache .ruff_cache htmlcov .coverage
+	find . -type d -name "__pycache__" -exec rm -rf {} +

package/templates/python-backend/README.md

@@ -0,0 +1,123 @@
+# AI Starter Kit
+
+Production-ready Python backend for AI application orchestration with LangGraph, OpenAI, and Anthropic.
+
+## AI / LLM Features
+
+| Feature | Description |
+|---------|-------------|
+| **LangGraph** | State machine orchestration for multi-step AI agents |
+| **Multi-provider LLMs** | OpenAI (GPT-4o) and Anthropic (Claude) with easy switching |
+| **Streaming** | Server-Sent Events for real-time token streaming |
+| **Tool calling** | Built-in tool execution with ReAct agent pattern |
+| **LangSmith** | Optional tracing and observability integration |
+| **Memory** | Conversation memory with checkpointing |
+
+## Performance Packages Included
+
+| Package | Purpose | Why It's Fast |
+|---------|---------|---------------|
+| **FastAPI** | Web framework | Built on Starlette, async-first, fastest Python framework |
+| **uvicorn** | ASGI server | Uses uvloop (libuv-based event loop) |
+| **orjson** | JSON serialization | Written in Rust, 3-10x faster than stdlib json |
+| **msgspec** | Serialization/validation | Zero-copy deserialization, faster than Pydantic |
+| **polars** | DataFrames | Rust-based, multithreaded, lazy evaluation |
+| **asyncpg** | PostgreSQL driver | Native async, fastest Python PostgreSQL driver |
+| **pendulum** | Date/time | Drop-in datetime replacement with better perf |
+| **httpx** | HTTP client | Async support, HTTP/2 support |
+| **structlog** | Logging | Structured logging with minimal overhead |
+
+## Quick Start
+
+```bash
+# Create virtual environment
+python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+
+# Install dependencies
+pip install -e ".[dev]"
+
+# Copy environment file
+cp .env.example .env
+
+# Run development server
+uvicorn src.main:app --reload --host 0.0.0.0 --port 8000
+```
+
+## Project Structure
+
+```
+python-backend/
+├── src/
+│   ├── features/           # Feature-based organization
+│   │   ├── agents/         # LangGraph agent workflows
+│   │   ├── chat/           # Chat completion endpoints
+│   │   ├── health/         # Health check endpoints
+│   │   └── orders/         # Order management example
+│   ├── lib/                # Shared utilities
+│   │   ├── agents.py       # LangGraph agent builder & tools
+│   │   ├── cache.py        # In-memory caching
+│   │   ├── database.py     # Async SQLAlchemy setup
+│   │   ├── llm.py          # LLM provider abstraction
+│   │   └── logging.py      # Structured logging
+│   ├── config.py           # Settings via pydantic-settings
+│   └── main.py             # Application entry point
+├── tests/                  # Test files
+├── pyproject.toml          # Dependencies & tool config
+└── .env.example            # Environment template
+```
+
+## Development Commands
+
+```bash
+# Run tests
+pytest
+
+# Run tests with coverage
+pytest --cov=src --cov-report=html
+
+# Type checking
+mypy src
+
+# Linting & formatting
+ruff check src tests
+ruff format src tests
+
+# Run with auto-reload
+uvicorn src.main:app --reload
+```
+
+## API Endpoints
+
+### Chat Completions
+```bash
+# Streaming chat (SSE)
+curl -X POST http://localhost:8000/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{"messages": [{"role": "user", "content": "Hello!"}], "stream": true}'
+
+# Non-streaming chat
+curl -X POST http://localhost:8000/chat/completions/sync \
+  -H "Content-Type: application/json" \
+  -d '{"messages": [{"role": "user", "content": "Hello!"}]}'
+```
+
+### Agent Workflows
+```bash
+# Invoke agent with tools
+curl -X POST http://localhost:8000/agents/invoke \
+  -H "Content-Type: application/json" \
+  -d '{"message": "What time is it and calculate 42 * 17?"}'
+
+# List available tools
+curl http://localhost:8000/agents/tools
+```
+
+## API Documentation
+
+- **Swagger UI**: http://localhost:8000/docs
+- **ReDoc**: http://localhost:8000/redoc
+
+## License
+
+MIT

package/templates/python-backend/pyproject.toml

@@ -0,0 +1,143 @@
+[project]
+name = "python-starter-kit"
+version = "1.0.0"
+description = "AI-powered Python backend with LangGraph orchestration"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    # Web Framework - fastest Python web framework
+    "fastapi>=0.115.0",
+    
+    # ASGI Server - high performance
+    "uvicorn[standard]>=0.32.0",
+    
+    # Fast JSON serialization/deserialization
+    "orjson>=3.10.0",
+    
+    # Ultra-fast serialization library (faster than pydantic for many cases)
+    "msgspec>=0.19.0",
+    
+    # High-performance DataFrame library (faster than pandas)
+    "polars>=1.18.0",
+    
+    # Async PostgreSQL driver
+    "asyncpg>=0.30.0",
+    
+    # Async SQLAlchemy ORM
+    "sqlalchemy[asyncio]>=2.0.36",
+    
+    # Environment variables
+    "python-dotenv>=1.0.0",
+    
+    # Data validation (Pydantic v2 with Rust core)
+    "pydantic>=2.10.0",
+    "pydantic-settings>=2.6.0",
+    
+    # Caching with Redis
+    "redis>=5.2.0",
+    
+    # HTTP client (async)
+    "httpx>=0.28.0",
+    
+    # Date/time handling (faster than datetime)
+    "pendulum>=3.0.0",
+    
+    # LRU cache with TTL
+    "cachetools>=5.5.0",
+    
+    # Structured logging
+    "structlog>=24.4.0",
+    
+    # ===== AI / LLM Orchestration =====
+    # LangGraph - state machine orchestration for AI agents
+    "langgraph>=0.2.0",
+    
+    # LangChain core abstractions
+    "langchain>=0.3.0",
+    "langchain-core>=0.3.0",
+    
+    # LLM Providers
+    "langchain-openai>=0.2.0",
+    "langchain-anthropic>=0.2.0",
+    "openai>=1.50.0",
+    "anthropic>=0.39.0",
+    
+    # LangSmith for tracing & observability
+    "langsmith>=0.1.140",
+    
+    # Embeddings & Vector stores
+    "langchain-community>=0.3.0",
+    
+    # Tiktoken for token counting
+    "tiktoken>=0.8.0",
+    
+    # Server-Sent Events for streaming
+    "sse-starlette>=2.1.0",
+    
+    # Tenacity for retry logic
+    "tenacity>=9.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    # Testing
+    "pytest>=8.3.0",
+    "pytest-asyncio>=0.24.0",
+    "pytest-cov>=6.0.0",
+    "httpx>=0.28.0",
+    
+    # Type checking
+    "mypy>=1.13.0",
+    
+    # Linting & Formatting
+    "ruff>=0.8.0",
+    
+    # Hot reload for development
+    "watchfiles>=1.0.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "UP",     # pyupgrade
+    "ARG",    # flake8-unused-arguments
+    "SIM",    # flake8-simplify
+]
+ignore = ["E501"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["src"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_ignores = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+addopts = "-v --tb=short"
+
+[tool.coverage.run]
+source = ["src"]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+]

package/templates/python-backend/src/__init__.py

@@ -0,0 +1 @@
+

package/templates/python-backend/src/config.py

@@ -0,0 +1,50 @@
+from pydantic_settings import BaseSettings
+from functools import lru_cache
+from typing import Literal
+
+
+class Settings(BaseSettings):
+    app_name: str = "AI Starter Kit"
+    debug: bool = False
+    
+    # Database
+    database_url: str = "postgresql+asyncpg://postgres:postgres@localhost:5432/app"
+    
+    # Redis
+    redis_url: str = "redis://localhost:6379"
+    
+    # Server
+    host: str = "0.0.0.0"
+    port: int = 8000
+    
+    # ===== AI / LLM Configuration =====
+    # OpenAI
+    openai_api_key: str = ""
+    openai_model: str = "gpt-4o"
+    openai_embedding_model: str = "text-embedding-3-small"
+    
+    # Anthropic
+    anthropic_api_key: str = ""
+    anthropic_model: str = "claude-sonnet-4-20250514"
+    
+    # Default LLM provider
+    default_llm_provider: Literal["openai", "anthropic"] = "openai"
+    
+    # LangSmith (optional - for tracing)
+    langsmith_api_key: str = ""
+    langsmith_project: str = "ai-starter-kit"
+    langsmith_tracing: bool = False
+    
+    # LLM Settings
+    llm_temperature: float = 0.7
+    llm_max_tokens: int = 4096
+    llm_streaming: bool = True
+    
+    class Config:
+        env_file = ".env"
+        env_file_encoding = "utf-8"
+
+
+@lru_cache
+def get_settings() -> Settings:
+    return Settings()

package/templates/python-backend/src/features/__init__.py

@@ -0,0 +1 @@
+

package/templates/python-backend/src/features/agents/__init__.py

@@ -0,0 +1,3 @@
+from .router import router
+
+__all__ = ["router"]