---
id: types-gunicorn
version: "26.0.0.20260807"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-gunicorn — Typing stubs for gunicorn

License: permissive · Maintenance: active · Downloads: 229.6K/mo

## What it is and what it does

types-gunicorn is a type stub package that provides type annotations for gunicorn. It allows static type checkers like mypy, pyright, and ty to understand and validate code that uses gunicorn, catching type errors before runtime. The stubs are maintained as part of the typeshed project and aim to provide accurate annotations for gunicorn==26.0.0.

This package contains no runtime code—it exists solely to improve the developer experience when working with gunicorn in a type-checked codebase. It has no dependencies beyond Python >=3.10 and integrates transparently with standard type checkers. The stubs have been tested with mypy 2.3.0, pyright 1.1.411, and ty 0.0.59.

Use it for:

- Enable type checkers to validate code that imports and configures gunicorn applications.
- Catch type errors in gunicorn configuration and WSGI app setup before runtime.
- Provide IDE autocomplete and inline documentation for gunicorn APIs during development.
- Validate gunicorn integration in a larger application's type-checked codebase.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type stubs for gunicorn to enable static type checking of code that uses the gunicorn WSGI HTTP server.

Yes, if you use gunicorn and type-check your code. It is a lightweight, actively maintained package with no dependencies that directly improves type safety. Install it alongside gunicorn in projects where static type checking is part of your workflow.

## Install

pip install types-gunicorn
uv add types-gunicorn
poetry add types-gunicorn

## Installing types-gunicorn

Before you install: Low install friction with no runtime dependencies. Actively maintained as part of the typeshed project, with the last commit on 2026-08-14.

License in practice: Licensed under Apache-2.0, a permissive open-source license that allows use, modification, and distribution with minimal restrictions.

Quickstart:

pip install types-gunicorn

# In your Python code with a type checker:
import gunicorn.app.base

app = gunicorn.app.base.BaseApplication()

Requires Python >=3.10. Requires gunicorn itself to be installed separately for runtime use.

Verify before relying:

- Whether these stubs remain accurate as gunicorn evolves beyond version 26.0.0
- Coverage completeness for all gunicorn APIs and edge cases

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 229.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

gunicorn type stubs, type checking gunicorn, gunicorn type hints, static analysis gunicorn, mypy gunicorn, pyright gunicorn, gunicorn typing support, type-stubs, wsgi

[View on SkillFed](https://skillfed.io/packages/types-gunicorn) · [View on PyPI](https://pypi.org/project/types-gunicorn/)