fastapi-scaffolding
Generate and maintain the FastAPI backend structure for the RAG chatbot with proper project organization.
When & Why to Use This Skill
This Claude skill automates the generation and maintenance of a professional FastAPI backend scaffolding specifically optimized for RAG (Retrieval-Augmented Generation) chatbots. It ensures high-quality project organization by automatically creating standardized directory structures, essential API endpoints, CORS configurations, and Uvicorn startup scripts, all while adhering to PEP 8 standards and modern Python type-hinting practices.
Use Cases
- Rapidly bootstrapping a production-ready FastAPI backend for new AI chat applications, saving hours of manual boilerplate setup.
- Standardizing project architecture across development teams to ensure consistent folder structures for routers, services, and schemas.
- Automating the creation of health check endpoints and CORS middleware to ensure immediate deployment readiness on cloud platforms.
- Generating clean, PEP 8-compliant Python code for RAG service placeholders, allowing developers to focus on core LLM logic rather than infrastructure.
| name | FastAPI Scaffolding |
|---|---|
| description | Generate and maintain the FastAPI backend structure for the RAG chatbot with proper project organization. |
FastAPI Scaffolding
Instructions
Create or update the backend folder structure with these directories:
- app/
- main.py (entry point with health endpoint)
- routers/ (for API endpoints)
- services/ (for business logic)
- schemas/ (for Pydantic models)
- deps/ (for dependency injection)
- app/
Generate main.py with:
- FastAPI app initialization
- Health check endpoint at GET /health
- CORS middleware configuration
- Include routers setup
Create a chat router placeholder in routers/chat.py
- Include basic route registration
- Setup for POST /chat endpoint
Ensure proper Uvicorn configuration in requirements.txt and startup command
- Include uvicorn, fastapi in dependencies
- Provide proper startup command: uvicorn app.main:app --host 0.0.0.0 --port 7860
Follow deterministic, clean Python code standards
- Use proper type hints
- Follow PEP 8 style guidelines
- Include proper error handling
Examples
Input: "Create FastAPI backend structure" Output: Creates the complete directory structure with main.py containing:
from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware
from app.routers import chat
app = FastAPI(title="Physical AI & Humanoid Robotics RAG API")
app.add_middleware(
CORSMiddleware,
allow_origins=["*"], # Configure appropriately for production
allow_credentials=True,
allow_methods=["*"],
allow_headers=["*"],
)
@app.get("/health")
async def health_check():
return {"status": "healthy"}
app.include_router(chat.router, prefix="/api/v1")