README
============
Tortoise ORM
Introduction
Tortoise ORM is an easy-to-use asyncio ORM (Object Relational Mapper) inspired by Django.
You can find the docs at Documentation
Tortoise ORM supports CPython 3.10 and later for SQLite, MySQL, PostgreSQL, Microsoft SQL Server, and Oracle.
Why was Tortoise ORM built?
Tortoise ORM was built to provide a lightweight, async-native Object-Relational Mapper for Python with a familiar Django-like API.
Tortoise ORM performs well when compared to other Python ORMs. Here are our benchmarks on PostgreSQL 17, where we measure different read and write operations (rows/sec, more is better):
How is an ORM useful?
An Object-Relational Mapper (ORM) abstracts database interactions, allowing developers to work with databases using high-level, object-oriented code instead of raw SQL.
- Reduces boilerplate SQL, allowing faster development with cleaner, more readable code.
- Helps prevent SQL injection by using parameterized queries.
- Centralized schema and relationship definitions make code easier to manage and modify.
- Handles schema changes through version-controlled migrations.