Front Matter

Information about the Alembic project.

Project Homepage

Alembic is hosted on GitHub at under the SQLAlchemy organization.

Releases and project status are available on Pypi at

The most recent published version of this documentation should be at


Install released versions of Alembic from the Python package index with pip or a similar tool:

pip install alembic

Installation via source distribution is via the script:

python install

The install will add the alembic command to the environment. All operations with Alembic then proceed through the usage of this command.


Alembic’s install process will ensure that SQLAlchemy is installed, in addition to other dependencies. Alembic will work with SQLAlchemy as of version 0.9.0, however more features are available with newer versions such as the 1.1 or 1.2 series.

Changed in version 1.0.0: Support for SQLAlchemy 0.8 and 0.7.9 was dropped.

Alembic supports Python versions 2.7, 3.4 and above.

Changed in version 1.0.0: Support for Python 2.6 and 3.3 was dropped.


Alembic is developed by Mike Bayer, and is loosely associated with the SQLAlchemy, Pylons, and Openstack projects.

User issues, discussion of potential bugs and features should be posted to the Alembic Google Group at sqlalchemy-alembic.


Bugs and feature enhancements to Alembic should be reported on the GitHub issue tracker.