tortoise/aerich

Health v2 · maintenance only

Adoption not part of the score

1084 stars · 113 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Aerich is a database migration tool for TortoiseORM, similar to Alembic for SQLAlchemy or Django's built-in migrations. It provides a CLI to generate, apply, and roll back schema migrations for MySQL, PostgreSQL, and SQLite databases.

Use cases

• manage tortoise orm database migrations
• generate migration files from tortoise orm models
• upgrade and downgrade database schema versions
• introspect existing database tables into tortoise models
• initialize migration folders for a tortoise orm project

When to choose

• you use TortoiseORM and need versioned schema migrations
• you want Alembic-like or Django-like migration workflows for an async Python ORM
• you need to roll back database schema changes safely

When to avoid

• you use SQLAlchemy (use Alembic instead)
• you use TortoiseORM >= 1.0.0, which has built-in migration CLI support
• you need migrations for ORMs other than TortoiseORM

Facets

cli-tool · maturity active

database orm cli developer-tools databases developer-tools backend python cli cross-platform tortoise-orm database-migrations schema-migrations mysql postgresql sqlite async-orm

Member repositories

For agents

markdown · JSON · MCP: product_card(name="tortoise/aerich")