# miguelgrinberg/Flask-Migrate

SQLAlchemy database migrations for Flask applications using Alembic

Repository: https://github.com/miguelgrinberg/Flask-Migrate
Canonical: https://ross.abutalabs.com/products/flask-migrate
Language: Python
License: MIT
License Family: permissive
Topics: python, flask, database, sqlalchemy-database-migrations, alembic, migrations
Last push: 2026-05-14T19:42:31+00:00

## Health v2 (maintenance only)
Score: 60/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 82, release rhythm 8, longevity 100
- inputs: {"age_days": 4742, "days_push": 111, "days_rel": 600, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2404, forks 235 (observed 2026-08-28T04:06:44.035192+00:00)

## What it is
Flask-Migrate is a Flask extension that wraps Alembic to handle SQLAlchemy database migrations. It exposes migration operations as command-line arguments under the `flask db` command.

## Use cases
- manage sqlalchemy schema migrations in a flask app
- create and apply database migrations with flask db commands
- version control database schema changes for a flask project
- sync database schema across environments using alembic
- upgrade an existing flask database schema after model changes

## When to choose
- you have a Flask application using Flask-SQLAlchemy or SQLAlchemy and need schema migrations
- you want Alembic migrations integrated with Flask's CLI
- you need reproducible database upgrades across development and production

## When to avoid
- your project does not use Flask or SQLAlchemy
- you need migrations for non-SQL databases
- you use a different web framework with its own migration tooling

## Facets
- artifact type: library
- maturity: stable
- function: database, cli
- domain: databases, web-development, developer-tools
- platform: python, cli
- tags: flask, sqlalchemy, alembic, database-migrations, flask-extension

## Member repositories
- miguelgrinberg/Flask-Migrate (main) score 60

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:44.035192+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:34:10.913519+00:00, confidence not recorded.
  - readme: https://github.com/miguelgrinberg/Flask-Migrate (fetched 2026-08-28T04:06:44.035192+00:00, sha d85efd79504a)
  - registry_pypi: https://pypi.org/pypi/flask-migrate/json (fetched 2026-08-29T10:14:28.172230+00:00, sha ce75ada9ffe0)
- Data as of 2026-08-30T08:39:29.467469+00:00.