fastapi-fullstack 0.1.5__tar.gz → 0.1.7__tar.gz

{fastapi_fullstack-0.1.5 → fastapi_fullstack-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-fullstack
-Version: 0.1.5
+Version: 0.1.7
 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-fastapi-nextjs-llm-template
 Project-URL: Documentation, https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template#readme
@@ -21,6 +21,7 @@ Classifier: Topic :: Software Development :: Code Generators
 Requires-Python: >=3.11
 Requires-Dist: click>=8.1.0
 Requires-Dist: cookiecutter>=2.6.0
+Requires-Dist: email-validator>=2.0.0
 Requires-Dist: pydantic-settings>=2.0.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: questionary>=2.0.0
@@ -85,6 +86,10 @@ This template gives you all of that out of the box, with **20+ configurable inte
 - 🏢 **Enterprise SaaS** - Full auth, admin panel, webhooks, and more
 - 🚀 **Startups** - Ship fast with production-ready infrastructure
 
+### AI-Agent Friendly
+
+Generated projects include **CLAUDE.md** and **AGENTS.md** files optimized for AI coding assistants (Claude Code, Codex, Copilot, Cursor, Zed). Following [progressive disclosure](https://humanlayer.dev/blog/writing-a-good-claude-md) best practices - concise project overview with pointers to detailed docs when needed.
+
 ---
 
 ## ✨ Features
@@ -95,7 +100,7 @@ This template gives you all of that out of the box, with **20+ configurable inte
 - **WebSocket Streaming** - Real-time responses with full event access
 - **Conversation Persistence** - Save chat history to database
 - **Custom Tools** - Easily extend agent capabilities
-- **Multi-model Support** - OpenAI, Anthropic, and more
+- **Multi-provider Support** - OpenAI, Anthropic, OpenRouter
 - **Observability** - Logfire for PydanticAI, LangSmith for LangChain
 
 ### ⚡ Backend (FastAPI)
@@ -133,32 +138,151 @@ This template gives you all of that out of the box, with **20+ configurable inte
   <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/app_start.gif" alt="FastAPI Fullstack Generator Demo">
 </p>
 
-### Screenshots
+---
 
-#### Chat Interface
-<p align="center">
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/new_chat_light.png" alt="Chat Interface - Light Mode"><br><br>
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/new_chat_dark.png" alt="Chat Interface - Dark Mode">
-</p>
+## 🚀 Quick Start
 
-#### Authentication
-<p align="center">
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/new_register.png" alt="Register Page with OAuth">
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/new_login.png" alt="Login Page with OAuth"><br><br>
-</p>
+### Installation
 
-#### Observability & Monitoring
-<p align="center">
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/logfire.png" alt="Logfire Observability Dashboard"><br><br>
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/langsmith.png" alt="LangSmith Tracing Dashboard"><br><br>
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/flower.png" alt="Celery Flower Task Monitoring">
-</p>
+```bash
+# pip
+pip install fastapi-fullstack
 
-#### Admin & API
-<p align="center">
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/admin.png" alt="SQLAdmin Panel"><br><br>
-  <img src="https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/docs_2.png" alt="API Documentation">
-</p>
+# uv (recommended)
+uv tool install fastapi-fullstack
+
+# pipx
+pipx install fastapi-fullstack
+```
+
+### Create Your Project
+
+```bash
+# Interactive wizard (recommended)
+fastapi-fullstack new
+
+# Quick mode with options
+fastapi-fullstack create my_ai_app \
+  --database postgresql \
+  --auth jwt \
+  --frontend nextjs
+
+# Use presets for common setups
+fastapi-fullstack create my_ai_app --preset production   # Full production setup
+fastapi-fullstack create my_ai_app --preset ai-agent     # AI agent with streaming
+
+# Minimal project (no extras)
+fastapi-fullstack create my_ai_app --minimal
+```
+
+### Start Development
+
+After generating your project, follow these steps:
+
+#### 1. Install dependencies
+
+```bash
+cd my_ai_app
+make install
+```
+
+#### 2. Start the database
+
+```bash
+# PostgreSQL (with Docker)
+make docker-db
+```
+
+#### 3. Create and apply database migrations
+
+```bash
+# Create initial migration (first time only)
+make db-migrate
+# Enter message: "Initial migration"
+
+# Apply migrations to create tables
+make db-upgrade
+```
+
+#### 4. Create admin user
+
+```bash
+make create-admin
+# Enter email and password when prompted
+```
+
+#### 5. Start the backend
+
+```bash
+make run
+```
+
+#### 6. Start the frontend (new terminal)
+
+```bash
+cd frontend
+bun install
+bun dev
+```
+
+**Access:**
+- API: http://localhost:8000
+- Docs: http://localhost:8000/docs
+- Admin Panel: http://localhost:8000/admin (login with admin user)
+- Frontend: http://localhost:3000
+
+### Quick Start with Docker
+
+Run everything in Docker:
+
+```bash
+make docker-up       # Start backend + database
+make docker-frontend # Start frontend
+```
+
+### Using the Project CLI
+
+Each generated project has a CLI named after your `project_slug`. For example, if you created `my_ai_app`:
+
+```bash
+cd backend
+
+# The CLI command is: uv run <project_slug> <command>
+uv run my_ai_app server run --reload     # Start dev server
+uv run my_ai_app db migrate -m "message" # Create migration
+uv run my_ai_app db upgrade              # Apply migrations
+uv run my_ai_app user create-admin       # Create admin user
+```
+
+Use `make help` to see all available Makefile shortcuts.
+
+---
+
+## 📸 Screenshots
+
+### Chat Interface
+| Light Mode | Dark Mode |
+|:---:|:---:|
+| ![Chat Light](https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/new_chat_light.png) | ![Chat Dark](https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/new_chat_dark.png) |
+
+### Authentication
+| Register | Login |
+|:---:|:---:|
+| ![Register](https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/new_register.png) | ![Login](https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/new_login.png) |
+
+### Observability
+| Logfire (PydanticAI) | LangSmith (LangChain) |
+|:---:|:---:|
+| ![Logfire](https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/logfire.png) | ![LangSmith](https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/langsmith.png) |
+
+### Admin, Monitoring & API
+| Celery Flower | SQLAdmin Panel |
+|:---:|:---:|
+| ![Flower](https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/flower.png) | ![Admin](https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/admin.png) |
+
+| API Documentation |
+|:---:|
+| ![API Docs](https://raw.githubusercontent.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/main/assets/docs_2.png) |
 
 ---
 
@@ -226,78 +350,33 @@ See [Architecture Documentation](https://github.com/vstorm-co/full-stack-fastapi
 
 ---
 
-## 🚀 Quick Start
-
-### Installation
-
-```bash
-# pip
-pip install fastapi-fullstack
-
-# uv (recommended)
-uv tool install fastapi-fullstack
-
-# pipx
-pipx install fastapi-fullstack
-```
-
-### Create Your Project
-
-```bash
-# Interactive wizard (recommended)
-fastapi-fullstack new
-
-# Quick mode with options
-fastapi-fullstack create my_ai_app \
-  --database postgresql \
-  --auth jwt \
-  --frontend nextjs
-```
+## 🤖 AI Agent
 
-### Start Development
+Choose between **PydanticAI** or **LangChain** when generating your project, with support for multiple LLM providers:
 
 ```bash
-cd my_ai_app
+# PydanticAI with OpenAI (default)
+fastapi-fullstack create my_app --ai-agent --ai-framework pydantic_ai
 
-# Backend
-cd backend
-uv sync
-cp .env.example .env
-alembic upgrade head
+# PydanticAI with Anthropic
+fastapi-fullstack create my_app --ai-agent --ai-framework pydantic_ai --llm-provider anthropic
 
-# Create admin user
-uv run my_ai_app user create --email admin@example.com --password secret123 --superuser
+# PydanticAI with OpenRouter
+fastapi-fullstack create my_app --ai-agent --ai-framework pydantic_ai --llm-provider openrouter
 
-# Start server
-uv run uvicorn app.main:app --reload
+# LangChain with OpenAI
+fastapi-fullstack create my_app --ai-agent --ai-framework langchain
 
-# Frontend (new terminal)
-cd frontend
-bun install
-bun dev
+# LangChain with Anthropic
+fastapi-fullstack create my_app --ai-agent --ai-framework langchain --llm-provider anthropic
 ```
 
-> **Note:** The admin user is required to access the SQLAdmin panel at `/admin`. Use the `--superuser` flag to grant full admin privileges.
-
-**Access:**
-- API: http://localhost:8000
-- Docs: http://localhost:8000/docs
-- Admin Panel: http://localhost:8000/admin
-- Frontend: http://localhost:3000
-
----
-
-## 🤖 AI Agent
+### Supported LLM Providers
 
-Choose between **PydanticAI** or **LangChain** when generating your project:
-
-```bash
-# PydanticAI (default)
-fastapi-fullstack create my_app --ai-agent --ai-framework pydantic_ai
-
-# LangChain
-fastapi-fullstack create my_app --ai-agent --ai-framework langchain
-```
+| Framework | OpenAI | Anthropic | OpenRouter |
+|-----------|:------:|:---------:|:----------:|
+| **PydanticAI** | ✓ | ✓ | ✓ |
+| **LangChain** | ✓ | ✓ | - |
 
 ### PydanticAI Integration
 
@@ -542,7 +621,7 @@ my_project/
 │   │   ├── schemas/             # Pydantic schemas
 │   │   ├── repositories/        # Data access layer
 │   │   ├── services/            # Business logic
-│   │   ├── agents/              # AI agents (PydanticAI or LangChain)
+│   │   ├── agents/              # AI agents with centralized prompts
 │   │   ├── commands/            # Django-style CLI commands
 │   │   └── worker/              # Background tasks
 │   ├── cli/                     # Project CLI
@@ -560,6 +639,14 @@ my_project/
 └── README.md
 ```
 
+Generated projects include version metadata in `pyproject.toml` for tracking:
+
+```toml
+[tool.fastapi-fullstack]
+generator_version = "0.1.5"
+generated_at = "2024-12-21T10:30:00+00:00"
+```
+
 ---
 
 ## ⚙️ Configuration Options
@@ -572,9 +659,18 @@ my_project/
 | **Auth** | `jwt`, `api_key`, `both`, `none` | JWT includes user management |
 | **OAuth** | `none`, `google` | Social login |
 | **AI Framework** | `pydantic_ai`, `langchain` | Choose your AI agent framework |
+| **LLM Provider** | `openai`, `anthropic`, `openrouter` | OpenRouter only with PydanticAI |
 | **Background Tasks** | `none`, `celery`, `taskiq`, `arq` | Distributed queues |
 | **Frontend** | `none`, `nextjs` | Next.js 15 + React 19 |
 
+### Presets
+
+| Preset | Description |
+|--------|-------------|
+| `--preset production` | Full production setup with Redis, Sentry, Kubernetes, Prometheus |
+| `--preset ai-agent` | AI agent with WebSocket streaming and conversation persistence |
+| `--minimal` | Minimal project with no extras |
+
 ### Integrations
 
 Select what you need:
@@ -605,18 +701,13 @@ fastapi-fullstack new
 | [Observability](https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/blob/main/docs/observability.md) | Logfire integration, tracing, metrics |
 | [Deployment](https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/blob/main/docs/deployment.md) | Docker, Kubernetes, production setup |
 | [Development](https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/blob/main/docs/development.md) | Local setup, testing, debugging |
+| [Changelog](https://github.com/vstorm-co/full-stack-fastapi-nextjs-llm-template/blob/main/docs/CHANGELOG.md) | Version history and release notes |
 
 ---
 
 ## Star History
 
-<a href="https://www.star-history.com/#vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date&legend=top-left">
- <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date&theme=dark" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date" />
-   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=Date" />
- </picture>
-</a>
+[![Star History Chart](https://api.star-history.com/svg?repos=vstorm-co/full-stack-fastapi-nextjs-llm-template&type=date&legend=top-left)](https://www.star-history.com/#vstorm-co/full-stack-fastapi-nextjs-llm-template&type=date&legend=top-left)
 
 ---