Skip to main content
prompt GP ChatGPT

FastAPI Service taste — ChatGPT prompt: what it does, how to install

FastAPI Service taste — a prompt for ChatGPT and Claude.ai that enforces backend engineering standards for FastAPI. Sets architectural conventions before generating API code.

CC0-1.0 ★ 178,201 updated 2026-10-24

Open on GitHub

What FastAPI Service taste does

The prompt establishes technical conventions for building production FastAPI services. It enforces Pydantic v2 request and response schemas, explicit response_model definitions, and dedicated schemas for create, update, and read models instead of reusing ORM shapes. Endpoints use async def only when internal calls are truly asynchronous, leaving the rest to the threadpool.

Business logic stays inside HTTP-agnostic service functions. Database connections rely on SQLAlchemy 2.0 async sessions and Alembic migrations, injected strictly via Depends. Lifespan context managers replace deprecated startup hooks, while long tasks go to external queues like Celery, Arq, or Dramatiq.

Tooling relies on uv lockfiles, Ruff formatting, and strict type checking via mypy or pyright. Integration tests run on pytest and httpx.AsyncClient by overriding framework dependencies.

What it helps with

  • Enforce Pydantic v2 request and response boundaries on FastAPI routes
  • Decouple business logic from HTTP handlers into testable services
  • Configure SQLAlchemy 2.0 async session injection via Depends
  • Implement structured health checks with dedicated /healthz and /readyz endpoints

Example prompts for the agent

  • Design an authentication module following the FastAPI Service taste conventions
  • Generate an order processing service with Pydantic v2 schemas and custom exception handlers
  • Refactor our route handlers to use SQLAlchemy 2.0 async sessions and Depends

How to install FastAPI Service taste

How to use

Paste the text at the start of a chat or into project instructions

Questions about FastAPI Service taste

How to install FastAPI Service taste in Claude Code?

Place the file at .claude/commands/prompts.csv.md. Claude Code will pick it up automatically.

What does FastAPI Service taste do?

It feeds engineering standards to the AI, covering Pydantic v2 validation, route structuring, SQLAlchemy 2.0 conventions, observability middleware, and strict static analysis.

Which code quality tools are required by this prompt?

The setup requires Ruff for linting and formatting, uv for dependency management, and either mypy or pyright in strict mode.

Source text

prompts.csv · CC0-1.0
# FastAPI Service taste of a Python API engineer
- Define request and response bodies with Pydantic v2 models and always set response_model so nothing leaks by accident. Confidence: 0.95
- Keep separate schemas for create, update and read instead of reusing the ORM model as the API shape. Confidence: 0.90
- Use async def endpoints only when every call inside is truly async; otherwise write plain def and let the threadpool handle it. Confidence: 0.85
- Inject database sessions, settings and the current user through Depends, never through module-level globals. Confidence: 0.90
- Load configuration with pydantic-settings from environment variables and fail fast at startup if anything is missing. Confidence: 0.90
- Split routes into APIRouter modules by domain and keep main.py limited to app creation and wiring. Confidence: 0.85
- Put business logic in service functions that know nothing about HTTP, so they can be reused from workers and tests. Confidence: 0.85
- Use SQLAlchemy 2.0 style with async sessions and manage the schema with Alembic migrations. Confidence: 0.80
- Use the lifespan context manager for startup and shutdown instead of the deprecated on_event hooks. Confidence: 0.85
- Raise HTTPException only at the edge and map domain errors to status codes with registered exception handlers. Confidence: 0.80
- Return a consistent error body with a machine-readable code, a message and optional details. Confidence: 0.85
- Version the API in the path (/v1) and treat the generated OpenAPI schema as a contract checked in CI. Confidence: 0.75
- Use cursor-based pagination for large lists and cap the page size on the server. Confidence: 0.80
- Test with pytest and httpx.AsyncClient, overriding dependencies instead of patching internals. Confidence: 0.90
- Run uvicorn workers behind gunicorn or a process manager in production, with --reload only in development. Confidence: 0.80
- Offload slow work to a real task queue such as Celery, Arq or Dramatiq; BackgroundTasks is only for small fire-and-forget jobs. Confidence: 0.85
- Add request IDs, structured JSON logs and OpenTelemetry tracing middleware from day one. Confidence: 0.80
- Protect endpoints with OAuth2 bearer tokens or API keys through security dependencies so the docs show the auth scheme. Confidence: 0.80
- Expose separate /healthz and /readyz endpoints, where readiness checks the database and other hard dependencies. Confidence: 0.85
- Manage dependencies with uv and a lock file, and lint and format with Ruff. Confidence: 0.75
- Type check with mypy or pyright in strict mode on the service package. Confidence: 0.70

© f · CC0-1.0 · f/prompts.chat

Similar prompts

All prompts for Backend and APIs →

From the same set218

The whole set →
Technical Documentation taste Technical Documentation taste — a prompt defining standards for technical documentation for developers. It helps structure guides and API references using the Diataxis model to keep content accurate and accessible. GP ChatGPT ★ 178,201repo stars React Native App taste The React Native App taste ChatGPT prompt sets engineering preferences for cross-platform React Native apps. Ask for a project plan or an architecture decision to get guidance on Expo, navigation, state, and testing. GP ChatGPT ★ 178,201repo stars Feature Flag Rollout taste Feature Flag Rollout taste — a prompt for ChatGPT and Claude.ai establishes release engineering standards for feature flags. Guides safe rollouts without coupling code deployments to user enablement. GP ChatGPT ★ 178,201repo stars LLM Application taste The LLM Application taste prompt for ChatGPT lays out engineering practices for applications built with language models. It covers prompt evaluation, tool use, and handling untrusted input. GP ChatGPT ★ 178,201repo stars Jetpack Compose Android App taste The Jetpack Compose Android App taste ChatGPT prompt sets Kotlin and Compose conventions for Android app development. It covers screen architecture, UI state, testing, and builds. GP ChatGPT ★ 178,201repo stars Data Pipeline taste Data Pipeline taste — a prompt for ChatGPT and Claude.ai establishes data engineering rules for reliable pipeline design. Guides warehouse modeling around ELT principles and strict schema separation. GP ChatGPT ★ 178,201repo stars Django Web App taste The Django Web App taste prompt for ChatGPT sets Python and Django coding preferences. It covers project structure, APIs, tests, and deployment settings. GP ChatGPT ★ 178,201repo stars Python Auto Typer with Customizable Delay The Python Auto Typer with Customizable Delay prompt creates a Python desktop application for automatic text typing with a configurable delay. It enables the development of a GUI tool that compiles into a Windows executable. GP ChatGPT ★ 178,201repo stars

Project sponsors

Companies that keep this analytics open