Change8

Alembic

Backend & Infra

A database migrations tool for SQLAlchemy.

Latest: rel_1_18_014 releases4 breaking changesView on GitHub →

Release History

rel_1_18_0
Jan 9, 2026
rel_1_17_21 fix1 feature
Nov 14, 2025

Version 1.17.2 introduces a replace parameter for operation implementations and fixes a SQL Server dialect bug related to default constraint handling.

rel_1_17_1Breaking1 fix1 feature
Oct 29, 2025

Version 1.17.1 introduces a new `--check-heads` option for `alembic current` and tightens revision ID validation by rejecting ':' characters, requiring migration of any existing colon‑containing IDs.

rel_1_17_0Breaking
Oct 11, 2025

Version 1.17.0 raises the minimum Python requirement to 3.10 and switches the internal test runner to nox, with tox support slated for removal.

rel_1_16_52 fixes
Aug 27, 2025

Release 1.16.5 resolves two bugs: correct MySQL index expression rendering and proper parsing of `truncate_slug_length` in pyproject.toml configuration.

rel_1_16_41 fix
Jul 10, 2025

This release resolves a bug in pyproject.toml handling that prevented boolean values for certain configuration options from being recognized.

rel_1_16_32 fixes2 features
Jul 8, 2025

Release 1.16.3 introduces the `pyproject_async` template and a new module post‑write hook for autogenerate, and fixes rendering issues with server defaults and foreign key constraints.

rel_1_16_22 fixes
Jun 16, 2025

Version 1.16.2 addresses two bugs: it restores proper rendering of dialect-specific keyword arguments for foreign key operations and corrects newline handling when updating `pyproject.toml`.

rel_1_16_12 fixes
May 21, 2025

Version 1.16.1 addresses two regressions introduced by a pathlib refactor, restoring proper template directory handling and fixing missing template error messages.

rel_1_16_0Breaking4 fixes6 features
May 21, 2025

Alembic 1.16.0 adds PEP 621 configuration, a new CLI registration API, enhanced path handling, and several operation flags, while fixing autogenerate and deprecation issues.

rel_1_15_21 fix
Mar 28, 2025

Bug fix for autogenerate handling of AlterColumnOp.modified_name.

rel_1_15_11 fix
Mar 4, 2025

Release 1.15.1 resolves an installation bug where Alembic's template files were omitted from the wheel distribution due to a PEP 621 pyproject.toml issue.

rel_1_15_0Breaking2 fixes2 features
Mar 4, 2025

Alembic 1.15.0 drops support for Python 3.8 and SQLAlchemy 1.3, adds label rendering for index autogeneration and revision context to diff detection, and includes several lint‑friendly and rendering bug fixes.

rel_1_14_12 fixes1 feature
Jan 19, 2025

Version 1.14.1 introduces SQLite column rename support, adds tzdata to tz extras, and resolves autogenerate Variant type rendering bugs.