---
id: types-flask-sqlalchemy
version: "2.5.9.4"
license: Apache-2.0 license
license_treatment: permissive
maintenance: active
---

# types-Flask-SQLAlchemy — Typing stubs for Flask-SQLAlchemy

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

## What it is and what it does

This package provides PEP 561 type stub files for Flask-SQLAlchemy, allowing static type checkers to understand and validate the types used in Flask-SQLAlchemy code. It acts as a bridge between the Flask-SQLAlchemy library and tools like mypy, pyright, and pytype, enabling developers to catch type errors before runtime.

The stubs depend on types-SQLAlchemy for core SQLAlchemy type information. However, the package is now largely superseded: Flask-SQLAlchemy has included its own type annotations since version 3.0.1, making this stub package redundant for modern codebases. It remains useful only for projects still using older versions of Flask-SQLAlchemy that lack built-in typing support.

Use it for:

- Type-checking Flask-SQLAlchemy code with mypy when using Flask-SQLAlchemy versions prior to 3.0.1.
- Enabling IDE autocomplete and type hints for Flask-SQLAlchemy in editors like PyCharm when using older versions.
- Validating ORM queries and model definitions against type contracts in legacy projects.
- Integrating Flask-SQLAlchemy into a typed Python codebase that uses pyright or pytype for static analysis.

## Worth the install?

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

Provides type stubs for Flask-SQLAlchemy to enable static type checking with mypy, pyright, pytype, and other PEP 561-compatible tools.

No, unless you are maintaining a legacy codebase using Flask-SQLAlchemy before version 3.0.1. For any modern Flask-SQLAlchemy project (3.0.1+), uninstall this package and rely on the library's built-in type annotations instead. The package has not been updated since May 2023 and will not receive updates for newer Flask-SQLAlchemy versions.

## Install

pip install types-flask-sqlalchemy
uv add types-flask-sqlalchemy
poetry add types-flask-sqlalchemy

## Installing types-Flask-SQLAlchemy

Before you install: Low friction to install as a wheel-only package with a single runtime dependency. Maintenance is active, though the package has not been updated since May 2023; note that Flask-SQLAlchemy 3.0.1+ includes its own type annotations, making this package redundant for newer versions.

License in practice: Apache-2.0 permissive license allows free use, modification, and distribution with minimal restrictions, suitable for both open-source and commercial projects.

Quickstart:

pip install types-Flask-SQLAlchemy

# Then use with your type checker (e.g., mypy)
# mypy your_flask_sqlalchemy_code.py

Only useful if you are using Flask-SQLAlchemy versions prior to 3.0.1, which did not include built-in type annotations. Flask-SQLAlchemy 3.0.1+ should be used without this package.

Verify before relying:

- Whether this package's type stubs remain accurate for Flask-SQLAlchemy versions since the last release in May 2023.
- Compatibility with the latest versions of mypy, pyright, and other type checkers that have evolved since the last update.

## Package facts

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

## Tags

flask-sqlalchemy type stubs, type checking flask-sqlalchemy, mypy stubs for flask-sqlalchemy, pep 561 type hints, static type checking orm, flask sqlalchemy typing, pyright flask-sqlalchemy, type-stubs, static-typing, legacy-support

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