Gunicorn with Uvicorn workers in FastAPI - Mini Project: Build & Apply

Gunicorn with Uvicorn Workers for FastAPI

📖 Scenario: You want to deploy a FastAPI application using Gunicorn as the process manager and Uvicorn as the worker class. This setup helps handle multiple requests efficiently in a production environment.

🎯 Goal: Create a FastAPI app, configure Gunicorn to use Uvicorn workers, and run the app with this configuration.

📋 What You'll Learn

Create a FastAPI app instance named app with a root endpoint returning a JSON message

Define a Gunicorn configuration variable workers set to 2

Use the Gunicorn command line to specify uvicorn.workers.UvicornWorker as the worker class

Run the FastAPI app with Gunicorn using the Uvicorn worker class and the specified number of workers

💡 Why This Matters

🌍 Real World

Deploying FastAPI apps in production requires a robust server setup. Gunicorn manages multiple worker processes, and Uvicorn provides asynchronous workers optimized for FastAPI.

💼 Career

Understanding how to deploy FastAPI with Gunicorn and Uvicorn is essential for backend developers working on scalable web services.

1

Create a FastAPI app with a root endpoint

Write code to import FastAPI, create an app instance named app, and add a root endpoint / that returns a JSON dictionary with {"message": "Hello, Gunicorn with Uvicorn!"}.

FastAPI

# Your code here

Need a hint?

Start by importing FastAPI, then create app = FastAPI(). Use @app.get("/") to define the root route that returns the JSON message.

2

Set Gunicorn worker count configuration

Add a variable named workers and set it to 2 to configure Gunicorn to use two worker processes.

FastAPI

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def read_root():
    return {"message": "Hello, Gunicorn with Uvicorn!"}

# Define number of Gunicorn workers
# Your code here

Need a hint?

Simply create a variable workers and assign it the value 2.

3

Use Gunicorn with Uvicorn worker class in command

Write the Gunicorn command to run the FastAPI app with the Uvicorn worker class. Use the app module name main and the app instance app. Include the --workers 2 option and specify the worker class as uvicorn.workers.UvicornWorker.

FastAPI

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def read_root():
    return {"message": "Hello, Gunicorn with Uvicorn!"}

workers = 2

# Write the Gunicorn command below
# Your code here

Need a hint?

Use the command format: gunicorn main:app --workers 2 --worker-class uvicorn.workers.UvicornWorker.

4

Run the FastAPI app with Gunicorn and Uvicorn workers

Add a comment line showing how to run the FastAPI app using Gunicorn with the Uvicorn worker class and the workers variable. Use the command format: gunicorn main:app --workers 2 --worker-class uvicorn.workers.UvicornWorker.

FastAPI

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def read_root():
    return {"message": "Hello, Gunicorn with Uvicorn!"}

workers = 2

# Command to run:
# gunicorn main:app --workers 2 --worker-class uvicorn.workers.UvicornWorker

# Your code here

Need a hint?

Just add a comment line with the full Gunicorn command to run the app with Uvicorn workers.