tortoise-orm 0.19.2


Easy async ORM for python, built with relations in mind

Easy async ORM for python, built with relations in mind

Stars: 3037, Watchers: 3037, Forks: 266, Open Issues: 361

The tortoise/tortoise-orm repo was created 4 years ago and was last updated 2 hours ago.
The project is very popular with an impressive 3037 github stars!

How to Install tortoise-orm

You can install tortoise-orm using pip

pip install tortoise-orm

or add it to a project with poetry

poetry add tortoise-orm

Package Details

Andrey Bondar
GitHub Repo


  • Database
  • Software Development/Libraries/Python Modules
No  tortoise-orm  pypi packages just yet.


A list of common tortoise-orm errors.

Code Examples

Here are some tortoise-orm code examples and snippets.

GitHub Issues

The tortoise-orm package has 361 open issues on GitHub

  • Pydantic serialisation include and exclude to relations
  • PEP 557 support
  • Fix for None values in prefetch when fk_id==0
  • TimeField is missing
  • db_url schema 'mysql+asyncmy' support
  • custom fields id error
  • Pass connection params
  • Make using DB-specific indexes (FULLTEXT) raise warning rather then error under sqlite
  • Model.refresh_from_db not work in transaction
  • Pydantic model generator: config_class implemented
  • Complex prefetch does not respect .only and always creates a full model
  • get dirty fields
  • camelCase for JSON serialization
  • JSONField fails to compare JSON values in database
  • GENERATED_SQL in Field does not work as intended (at all)

See more issues on GitHub

Related Packages & Articles

piccolo 0.82.0

A fast, user friendly ORM and query builder which supports asyncio.

fastapi 0.79.0

FastAPI framework, high performance, easy to learn, fast to code, ready for production