types-peewee

What it is and what it does

types-peewee is a type stub package that provides type annotations for the peewee ORM library. It allows Python type checkers like mypy, pyright, and ty to understand and validate code that uses peewee, catching type errors before runtime. The package is maintained as part of the typeshed project, the standard repository for Python type stubs, and is tested against multiple type checkers.

This is a stub-only package with no runtime dependencies—it exists purely to enhance your development experience by enabling static type checking. The package is marked as partial, meaning some annotations may be incomplete; the maintainers welcome contributions to fill gaps. It targets peewee 4.3.0 and requires Python 3.10 or later.

Use it for:

• Enable mypy or pyright to type-check a peewee-based application and catch database model errors early.
• Improve IDE autocomplete and inline documentation for peewee model definitions and queries.
• Validate peewee ORM usage in a CI/CD pipeline to prevent type-related bugs in production code.
• Contribute missing type annotations back to typeshed to help the broader Python community.
• Use peewee in a strictly typed codebase where all dependencies must have type support.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides type annotations for the peewee ORM library, enabling type checkers like mypy and pyright to validate code that uses peewee.

Yes, if you use peewee and want type checking. Install it alongside peewee to unlock static type validation in your IDE and CI pipeline. The package is lightweight, actively maintained, and has no runtime overhead. Only skip it if you do not use a type checker or do not use peewee.

Install

types-peewee on PyPI

pip install types-peewee

uv add types-peewee

poetry add types-peewee

Installing types-peewee

Before you install

Low friction installation with no runtime dependencies. Released 7 days ago with active maintenance; part of the typeshed project, which is the standard repository for Python type stubs.

License in practice

Licensed under Apache-2.0 (permissive), so you can use it freely in commercial and open-source projects without significant legal constraints.

Quickstart

pip install types-peewee

# Then use peewee with type checking:
import peewee

db = peewee.SqliteDatabase('test.db')

Requires Python 3.10 or later. Type stubs are only useful when used with a type checker (mypy, pyright, or ty); they do not affect runtime behavior.

Verify before relying

• Coverage completeness: the package is marked as partial; which peewee features lack annotations is not detailed in the fact sheet.
• Whether the stub version 4.3.0.20260807 aligns with peewee 4.3.0 exactly or covers a range of peewee versions.

Package facts

Evidence: types_peewee-4.3.0.20260807-py3-none-any.whl

Tags

More Database packages