fastapi-local-dev

Run FastAPI apps locally with Uvicorn hot-reloading and deploy with Gunicorn.

68|19|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/bobmatnyc/claude-mpm-skills --skill fastapi-local-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fastapi-local-dev
Source: https://github.com/bobmatnyc/claude-mpm-skills/tree/main/toolchains/python/frameworks/fastapi-local-dev
Command: npx skills add https://github.com/bobmatnyc/claude-mpm-skills --skill fastapi-local-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of running FastAPI applications locally for development and production, addressing common issues with hot-reloading, worker configurations, and deployment.

Core Features & Use Cases

  • Development Server: Easily start FastAPI with Uvicorn's auto-reloading for rapid development cycles.
  • Production Deployment: Provides guidance on using Gunicorn with Uvicorn workers for robust production deployments.
  • Cross-Platform Compatibility: Offers solutions for common issues on WSL and Docker environments.
  • Use Case: Quickly set up a FastAPI project for local development, ensuring that code changes are automatically detected and reloaded, and then deploy it to production using best practices for performance and stability.

Quick Start

Run your FastAPI application in development mode using uvicorn app.main:app --reload.

Frequently Asked Questions about fastapi-local-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a FastAPI application locally with hot-reloading using Uvicorn?

Run FastAPI locally for development using `uvicorn app.main:app --reload` to enable hot-reloading. This starts the Uvicorn server, automatically detects code changes, and refreshes the application to streamline rapid development cycles.

What is the best way to deploy FastAPI to production with Gunicorn and Uvicorn?

Deploy FastAPI to production using Gunicorn managed Uvicorn workers. This configuration provides robust process management and stability for handling concurrent requests, ensuring reliable production performance for your Python application.

Why does my FastAPI hot-reload not work correctly in WSL or Docker?

FastAPI hot-reload issues in WSL or Docker often stem from file system event polling limitations. This Skill provides specific cross-platform compatibility solutions and reload tuning instructions to ensure Uvicorn detects changes correctly.

Do I need Python and Gunicorn installed to use this FastAPI runbook?

Yes, you need Python, FastAPI, Uvicorn, and Gunicorn installed. These dependencies are required for the Skill to provide execution instructions for both local development server startup and production deployment process management.

How do I manage FastAPI production processes with systemd or PM2?

Manage FastAPI production processes using systemd or PM2 alongside Gunicorn and Uvicorn workers. This Skill addresses process management configurations to maintain application stability and handle deployment operations effectively.