# Alembic

Database migration tool for Python that runs versioned schema changes through SQLAlchemy.


Source: https://findsoftware.frbit.cloud/alembic/
Last reviewed: 2026-11-04
Listed since: 2026-11-04

## Record

### Links

- home: https://alembic.sqlalchemy.org
- repository: https://github.com/sqlalchemy/alembic
- docs: https://alembic.sqlalchemy.org/en/latest/
- forum: https://github.com/sqlalchemy/alembic/discussions/

### Identity

- status: active
- maintainer: Michael Bayer
- maintainerType: unknown
- parent: unknown
- firstRelease: 2011
- hqCountry: unknown

### Kind

- category: library
- hosting: python
- language: python
- runtime: python
- runtimeMin: python 3.10
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: sqlite, postgres, sqlserver, mysql
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: not applicable
- renderingModes: not applicable
- installMethod: pip

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 1
- latestReleaseDate: 2026-10-22

### Adoption

- githubStargazers: 4464
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 201
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 52456
- dependentPackages: 620

### Sources

- urls: https://alembic.sqlalchemy.org/ (read 2026-11-04)
- urls: https://api.github.com/repos/sqlalchemy/alembic (read 2026-11-04)
- urls: https://alembic.sqlalchemy.org/en/latest/ (read 2026-11-04)
- firstRelease: https://pypi.org/pypi/alembic/json (read 2026-11-04)
- maintainer: https://github.com/sqlalchemy/alembic/blob/main/LICENSE (read 2026-11-04)
- category: https://alembic.sqlalchemy.org/ (read 2026-11-04)
- language: https://github.com/sqlalchemy/alembic (read 2026-11-04)
- runtime: https://alembic.sqlalchemy.org/en/latest/front.html (read 2026-11-04)
- runtimeMin: https://github.com/sqlalchemy/alembic/blob/rel_1_20_1/pyproject.toml (read 2026-11-04)
- installMethod: https://alembic.sqlalchemy.org/en/latest/front.html (read 2026-11-04)
- databases: https://github.com/sqlalchemy/alembic/blob/main/README.rst (read 2026-11-04)
- databases: https://github.com/sqlalchemy/alembic/blob/main/README.rst (read 2026-11-04)
- databases: https://alembic.sqlalchemy.org/en/latest/changelog.html (read 2026-11-04)
- license: https://api.github.com/repos/sqlalchemy/alembic (read 2026-11-04)
- license: https://github.com/sqlalchemy/alembic/blob/main/LICENSE (read 2026-11-04)
- licenseModel: https://github.com/sqlalchemy/alembic/blob/main/LICENSE (read 2026-11-04)
- currentMajor: https://github.com/sqlalchemy/alembic/releases/tag/rel_1_20_1 (read 2026-11-04)
- latestReleaseDate: https://github.com/sqlalchemy/alembic/releases/tag/rel_1_20_1 (read 2026-11-04)
- githubStargazers: https://api.github.com/repos/sqlalchemy/alembic (read 2026-11-04)
- contributors: https://api.github.com/repos/sqlalchemy/alembic/contributors (read 2026-11-04)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/alembic (read 2026-11-04)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/alembic (read 2026-11-04)

## Notes

Alembic is a database migration tool for Python projects that use SQLAlchemy. It runs migration scripts that change a database's schema, and each script can upgrade the database to a new state or step it back down. The [README](https://github.com/sqlalchemy/alembic/blob/main/README.rst) describes an autogenerate step that compares the database with the SQLAlchemy models and writes candidate scripts for the developer to edit before running them.

Alembic installs from PyPI with pip. The README says Alembic is written by the author of SQLAlchemy, and the [front page](https://alembic.sqlalchemy.org/en/latest/front.html) states that it is part of the SQLAlchemy project.

## Worth knowing

SQLite supports few ALTER statements, so Alembic's batch mode rebuilds a table as a copy and moves the rows across when a migration changes it. The [batch page](https://alembic.sqlalchemy.org/en/latest/batch.html) describes this process.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0