AgentSkillsCN

fastapi-local-dev

FastAPI 开发与生产运行手册(Uvicorn 重载模式,Gunicorn)

SKILL.md
--- frontmatter
name: fastapi-local-dev
description: FastAPI dev/prod runbook (Uvicorn reload, Gunicorn)
version: 1.1.0
category: toolchain
author: Claude MPM Team
license: MIT
progressive_disclosure:
  entry_point:
    summary: "FastAPI dev: Uvicorn reload; prod: Gunicorn+UvicornWorker"
tags: [python, fastapi]

FastAPI Local Dev

  • Dev: uvicorn app.main:app --reload
  • Imports: run from repo root; use python -m uvicorn ... or PYTHONPATH=.
  • WSL: WATCHFILES_FORCE_POLLING=true if reload misses changes
  • Prod: gunicorn app.main:app -k uvicorn.workers.UvicornWorker -w <n> --bind :8000

Anti-patterns:

  • --reload --workers > 1
  • PM2 watch: true for Python

References: references/.