---
id: types-werkzeug
version: "1.0.9"
license: Apache-2.0 license
license_treatment: permissive
maintenance: active
---

# types-Werkzeug — Typing stubs for Werkzeug

License: permissive · Maintenance: active · Downloads: 1.8M/mo

## What it is and what it does

types-Werkzeug is a type stub package that bridges the gap between older versions of Werkzeug and modern type checkers. It provides type information for Werkzeug's public API, allowing tools like mypy, PyCharm, and pytype to perform static type checking on code that uses Werkzeug. The stubs are maintained as part of the typeshed project, a community repository of type definitions for popular Python packages.

However, this package has been superseded: Werkzeug itself has shipped with native type annotations since version 2.0, making types-Werkzeug redundant for any modern installation. The package has not been updated since November 2021, and the description explicitly recommends uninstalling it if you use Werkzeug 2.0 or later. It remains relevant only for legacy codebases still on Werkzeug 1.x.

Use it for:

- Type-checking legacy code that depends on Werkzeug 1.x with mypy or similar tools.
- Adding type safety to older Flask or Werkzeug-based projects without upgrading the framework.
- Verifying type correctness in CI/CD pipelines for applications locked to pre-2.0 Werkzeug versions.

## Worth the install?

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

Provides PEP 561 type stubs for Werkzeug, enabling type checkers like mypy and PyCharm to validate code using Werkzeug without runtime overhead.

No, unless you are constrained to Werkzeug 1.x. For any modern Werkzeug installation (2.0+), this package is unnecessary and should not be installed—Werkzeug's own type stubs are superior and kept in sync with releases. If you are on Werkzeug 1.x, it provides value, but upgrading Werkzeug is the better path forward.

## Install

pip install types-werkzeug
uv add types-werkzeug
poetry add types-werkzeug

## Installing types-Werkzeug

Before you install: Low install friction with no runtime dependencies. However, the package has not been updated since November 2021, and Werkzeug itself has included native type annotations since version 2.0—this stub package is now largely obsolete for modern Werkzeug installations.

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

Quickstart:

pip install types-Werkzeug

# Then use with mypy or other type checkers on code that imports Werkzeug
mypy your_code.py

Only useful if you are using Werkzeug version 1.x or early 2.0 releases; Werkzeug 2.0+ includes its own type stubs, making this package redundant.

Verify before relying:

- Whether this package remains compatible with current Werkzeug versions beyond 2.0.
- Whether type coverage is complete for all Werkzeug APIs or if gaps exist.

## Package facts

- License: Apache-2.0 license (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 1.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs werkzeug, mypy werkzeug typing, werkzeug type hints, pep 561 stubs, static type checking werkzeug, werkzeug type annotations, type checking flask werkzeug, type-stubs, deprecated

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