skill CX Codex

fastapi-local-dev — Claude Code skill: run FastAPI in dev and prod

Q: How do I install fastapi-local-dev in Claude?

Run `npx skills add bobmatnyc/claude-mpm-skills --skill fastapi-local-dev -a claude-code`. The skill file then sits at `~/.claude/skills/fastapi-local-dev/SKILL.md`.

Q: What does fastapi-local-dev do?

It is a FastAPI runbook: dev mode on Uvicorn with `--reload`, prod on Gunicorn with UvicornWorker, plus notes on imports, WSL and anti-patterns.

Q: Why should `--reload` not run with multiple workers?

The skill lists `--reload --workers > 1` as an anti-pattern. Production uses Gunicorn with UvicornWorker and the worker count you choose.

A runbook skill for FastAPI: Uvicorn with reload during development, Gunicorn with UvicornWorker in production.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add bobmatnyc/claude-mpm-skills --skill fastapi-local-dev -a claude-code

Open on GitHub

What fastapi-local-dev does

The skill hands you commands for both modes. Development: uvicorn app.main:app --reload. Production: gunicorn app.main:app -k uvicorn.workers.UvicornWorker -w <n> --bind :8000, with <n> filled in by you.

Imports get their own note: run from the repo root, either through python -m uvicorn ... or with PYTHONPATH=.. On WSL, when reload misses file changes, the skill suggests WATCHFILES_FORCE_POLLING=true.

There is an anti-patterns section. Two are named outright: pairing --reload with more than one worker, and watch: true in PM2 for Python. Worth checking your start scripts if FastAPI runs under PM2.

What it helps with

run FastAPI locally with auto-reload
start a production server on Gunicorn with UvicornWorker
fix imports when launching from the repo root
get auto-reload working under WSL
strip conflicting flags from a start command

Example prompts for the agent

What is the right way to run FastAPI in dev mode?
Build me a production command with Gunicorn and UvicornWorker
Reload misses changes on WSL — what should I do?

How to install fastapi-local-dev

1Skills CLI (Vercel)

npx skills add bobmatnyc/claude-mpm-skills --skill fastapi-local-dev -a claude-code

2Manually: put the files in place

~/.claude/skills/fastapi-local-dev/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/fastapi-local-dev/

1Skills CLI (Vercel)

npx skills add bobmatnyc/claude-mpm-skills --skill fastapi-local-dev -a codex

2Manually: put the files in place

.agents/skills/fastapi-local-dev/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add bobmatnyc/claude-mpm-skills --skill fastapi-local-dev -a cursor

2Manually: put the files in place

.cursor/skills/fastapi-local-dev/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install bobmatnyc/claude-mpm-skills fastapi-local-dev

2Manually: put the files in place

.github/skills/fastapi-local-dev/SKILL.md

1Skills CLI (Vercel)

npx skills add bobmatnyc/claude-mpm-skills --skill fastapi-local-dev -a gemini-cli

2Platform CLI

gemini skills install https://github.com/bobmatnyc/claude-mpm-skills --path toolchains/python/frameworks/fastapi-local-dev

Manually: put the files in place

.devin/skills/fastapi-local-dev/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add bobmatnyc/claude-mpm-skills --skill fastapi-local-dev -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about fastapi-local-dev

How do I install fastapi-local-dev in Claude?

Run npx skills add bobmatnyc/claude-mpm-skills --skill fastapi-local-dev -a claude-code. The skill file then sits at ~/.claude/skills/fastapi-local-dev/SKILL.md.

What does fastapi-local-dev do?

It is a FastAPI runbook: dev mode on Uvicorn with --reload, prod on Gunicorn with UvicornWorker, plus notes on imports, WSL and anti-patterns.

Why should --reload not run with multiple workers?

The skill lists --reload --workers > 1 as an anti-pattern. Production uses Gunicorn with UvicornWorker and the worker count you choose.

Source text

SKILL.md · MIT

---
name: fastapi-local-dev
description: FastAPI dev/prod runbook (Uvicorn reload, Gunicorn)
user-invocable: false
disable-model-invocation: true
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/`.

Similar skills

Everything for Backend and APIs →

fastapi-microservices-serverless Mindrally A skill that tells your coding agent how to build FastAPI microservices for serverless and cloud-native setups: stateless, Redis-backed, behind an API Gateway. CX Codex +1 724installs fastapi-templates Seth Hobson This skill scaffolds FastAPI projects with async routes, dependency injection, and error handling. Use it when starting a Python API. CX Codex 25,840installs fastapi-python Mindrally Tells the agent how to write FastAPI code: async I/O, Pydantic v2 models, early returns and router layout. Useful when you build a Python API. CX Codex +1 13,900installs fastapi-patterns affaan-m Provides production patterns for FastAPI, including Pydantic v2 schemas, async dependencies, and service layers. Useful when writing or reviewing API architectures. CX Codex +1 4,900installs fastapi-async-patterns TheBushidoCollective A skill with ready patterns for async routes, async databases, background tasks and WebSockets in FastAPI. Useful when your API stalls under concurrent requests. CX Codex +1 953installs fastapi-development aj-geddes A skill that steers your AI agent toward idiomatic FastAPI code: async routes, Pydantic validation, JWT auth and automatic OpenAPI docs. CX Codex +1 618installs

From the same set65

vercel-deployments-builds Walks through the Vercel deployment lifecycle: builds, previews, release phases and rollback. Useful when you configure build output or control releases. CX Codex +1 368installs stacked-prs A skill that walks the agent through building stacks of dependent pull requests, where each branch grows from the previous one instead of main. Useful when a large feature is split into phases. CX Codex +1 362installs better-auth-core A skill for wiring Better Auth into TypeScript apps: the instance, server handlers, client, and sessions. Useful when you need auth running without digging through docs. CX Codex +1 358installs reporting-pipelines A skill that fixes one pattern for report exports: collect data, normalize it, write CSV/JSON/Markdown with timestamped names into reports/. CX Codex +1 354installs headlessui A skill covering Headless UI: unstyled React and Vue components with keyboard navigation and ARIA built in. Useful when you want your own design without losing accessibility. CX Codex +1 345installs vercel-networking-domains A skill that walks the agent through Vercel domains, redirects, rewrites, headers and edge cache. Useful when you change traffic behavior rather than app code. CX Codex +1 344installs svelte Get Svelte 5 guidance for reactive components and SvelteKit apps. Use it when building UI state, bindings, routes, or data-loading flows. CX Codex +1 343installs env-manager Checks .env for structural errors, flags secrets sitting in client-exposed variables, and diffs the file against .env.example. Useful before a deploy. CX Codex +1 340installs