---
id: alembic
version: "1.19.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# alembic — A database migration tool for SQLAlchemy.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install alembic
uv add alembic
poetry add alembic

## Description

Alembic is a database migrations tool written by the author
of `SQLAlchemy <http://www.sqlalchemy.org>`_.  A migrations tool
offers the following functionality:

* Can emit ALTER statements to a database in order to change
  the structure of tables and other constructs
* Provides a system whereby "migration scripts" may be constructed;
  each script indicates a particular series of steps that can "upgrade" a
  target database to a new version, and optionally a series of steps that can
  "downgrade" similarly, doing the same steps in reverse.
* Allows the scripts to execute in some sequential manner.

The goals of Alembic are:

* Very open ended and transparent configuration and operation.   A new
  Alembic environment is generated from a set of templates which is selected
  among a set of options when setup first occurs. The templates then deposit a
  series of scripts that define fully how database connectivity is established
  and how migration scripts are invoked; the migration scripts themselves are
  generated from a template within that series of scripts. The scripts can
  then be further customized to define exactly how databases will be
  interacted with and what...

## AI interpretation — verify before relying

Alembic is a database migrations tool that generates and manages schema changes for SQLAlchemy-backed applications, supporting both automatic migration generation from model changes and manual migration scripts with full transactional DDL support.

Verdict: Alembic is a production-stable, actively maintained database migration tool with low install friction and strong community adoption. Its MIT license poses no restrictions for most use cases. The tool is well-suited for any SQLAlchemy project requiring schema versioning, with no known security vulnerabilities and broad Python version support.

[View on SkillFed](https://skillfed.io/packages/alembic) · [View on PyPI](https://pypi.org/project/alembic/)