tortoise/tortoise-orm

View on GitHub

Familiar asyncio ORM for python, built with relations in mind

Stars: 5.6k
Forks: 516
Open beginner issues: 0
Indexed issues: 460
Avg merge: 2d 21h
Merged PRs (30d): 9

Dominant language: Python
License: Apache-2.0
Last GitHub push: Sep 17, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: good first issue help wanted

Beginner friendly Everything

Open All

460 issues indexed so far

DROP INDEX in migrations is not schema-qualified (PostgreSQL/Oracle) — breaks RemoveIndex/RemoveConstraint for models outside the default schema Open

Difficulty 3/5 1-2 days Newbie friendliness 70/100

tortoise/tortoise-orm#2288 · Opened Sep 19, 2026
Constraints defined within Meta are not applied when performing data migrations. Open

Difficulty 3/5 1-2 days Newbie friendliness 68/100

tortoise/tortoise-orm#2272 · 3 comments · Opened Sep 5, 2026
Database Inspection? Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

tortoise/tortoise-orm#2265 · Opened Aug 24, 2026
Migrations not adding inherited fields until 2nd migration, and not making PKs generated Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

tortoise/tortoise-orm#2251 · 1 comment · Opened Jul 22, 2026
`.values_list()` / `.values()` silently drop `select_for_update()` - rows are not locked Open

Difficulty 3/5 1-2 days Newbie friendliness 74/100

tortoise/tortoise-orm#2250 · Opened Jul 18, 2026
add an option to create raw SQL statement in tortoise makemigrations. Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

tortoise/tortoise-orm#2242 · Opened Jul 8, 2026
ConnectionHandler.close_all can leak cross-loop connections after loop-switch reconnect Open

Difficulty 4/5 3-5 days Newbie friendliness 68/100

tortoise/tortoise-orm#2240 · Opened Jul 8, 2026
fetch_related() should allow a manager to be passed as an arg. Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

tortoise/tortoise-orm#2234 · Opened Jul 1, 2026
[Bug] ForeignKey ignores to_field and forces lookup on default PK field, causing type/mapping errors Open

Difficulty 3/5 1-2 days Newbie friendliness 68/100

tortoise/tortoise-orm#2225 · Opened Jun 21, 2026
Regarding db_constraint, I think this is a bug Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

tortoise/tortoise-orm#2223 · 1 comment · 1 reaction · Opened Jun 19, 2026
tortoise makemigration generated duplicate table Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

tortoise/tortoise-orm#2193 · 5 comments · Opened May 15, 2026
TortoiseContext context manager breaks when used by parallel tasks Open

Difficulty 3/5 1-2 days Newbie friendliness 62/100

tortoise/tortoise-orm#2186 · 6 comments · Opened May 8, 2026
Mixed model union queries behave like UNION ALL Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

tortoise/tortoise-orm#2185 · 1 comment · Opened May 7, 2026
Repeated generation migration Open

Difficulty 3/5 1-2 days Newbie friendliness 55/100

tortoise/tortoise-orm#2176 · 9 comments · 1 reaction · Opened Apr 8, 2026
[Enhancement] Improve Developer Experience (DX) by using `TypedDict` and `Unpack` (PEP 692) for `Field.__init__` Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

tortoise/tortoise-orm#2168 · 2 comments · Opened Apr 4, 2026
`bulk_update()` ignores explicitly set values for `DatetimeField(auto_now=True)` and recalculates timestamp per object Open

Difficulty 3/5 1-2 days Newbie friendliness 65/100

tortoise/tortoise-orm#2133 · 4 comments · Opened Mar 8, 2026
Generated SQL missing fk in table definition Open

Difficulty 4/5 3-5 days Newbie friendliness 48/100

tortoise/tortoise-orm#2119 · 1 comment · Opened Feb 27, 2026
from_tortoise_orm generated redundant queries Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

tortoise/tortoise-orm#2115 · 2 comments · Opened Feb 22, 2026
The as_query method in the queryset.py file has been removed Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

tortoise/tortoise-orm#2056 · 14 comments · Opened Jan 14, 2026
AWS IAM based authentication (RDS / Aurora) support Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

tortoise/tortoise-orm#2034 · Opened Dec 12, 2025
Add execute method to QuerySetSingle and AwaitableQuery for sync contexts Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

tortoise/tortoise-orm#2028 · 1 comment · Opened Dec 3, 2025
Feature: SQL view class Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

tortoise/tortoise-orm#2019 · 3 comments · 1 reaction · Opened Nov 22, 2025
Misbehaving model `save()` when names are too long Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

tortoise/tortoise-orm#2018 · 3 comments · Opened Nov 21, 2025
Subclassing of QuerySet Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

tortoise/tortoise-orm#2010 · Opened Oct 18, 2025
Getting `psycopg.OperationalError` constantly after a while on transactions Open

bug

Difficulty 4/5 3-5 days Newbie friendliness 35/100

tortoise/tortoise-orm#2007 · Opened Sep 21, 2025
select_related not preserved in ValuesQuery Open

bug

Difficulty 4/5 3-5 days Newbie friendliness 35/100

tortoise/tortoise-orm#2004 · Opened Sep 10, 2025
A question about filter queries, is it unsupported or a bug? Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

tortoise/tortoise-orm#2003 · 5 comments · Opened Sep 8, 2025
Add exists filter syntax Open

Difficulty 5/5 Over a week Newbie friendliness 42/100

tortoise/tortoise-orm#2002 · 2 comments · 1 reaction · Opened Sep 3, 2025
Tortoise Admin Panel Open

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

tortoise/tortoise-orm#1998 · 6 reactions · Opened Aug 25, 2025
Awaiting `Model.bulk_create` on a list of objects returns None and also does not fill the `id` field of the list items! Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

tortoise/tortoise-orm#1992 · 1 comment · 1 reaction · Opened Aug 16, 2025
Typing issue with `ForeignKeyNullableRelation` Open

Difficulty 3/5 1-2 days Newbie friendliness 42/100

tortoise/tortoise-orm#1986 · 2 comments · Opened Aug 1, 2025
Tortoise + FastAPI StreamingResponse returns WRONG query results Open

Difficulty 4/5 3-5 days Newbie friendliness 42/100

tortoise/tortoise-orm#1984 · 3 comments · Opened Jul 30, 2025
Allow UNIQUE postgres indexes Open

Difficulty 4/5 3-5 days Newbie friendliness 42/100

tortoise/tortoise-orm#1980 · Opened Jul 23, 2025
Mongoose-like global model registration [Feature request] Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

tortoise/tortoise-orm#1976 · 1 reaction · Opened Jun 26, 2025
tortoise.contrib.test.initializer relies on PGDATABASE env var even if db_url is provided Open

Difficulty 3/5 1-2 days Newbie friendliness 50/100

tortoise/tortoise-orm#1973 · Opened Jun 24, 2025
Init function run on each connection? Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

tortoise/tortoise-orm#1964 · 1 comment · Opened Jun 8, 2025
json_contains NotImplementedError with SQLite - only works with PostgreSQL Open

Difficulty 3/5 1-2 days Newbie friendliness 35/100

tortoise/tortoise-orm#1961 · 1 comment · 2 reactions · Opened May 31, 2025
the dependency packsges "iso8601" and "pytz" can realize by the ORM itself? Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

tortoise/tortoise-orm#1956 · 7 comments · Opened May 23, 2025
Postgres connection string (dsn) with multi-host does not work Open

enhancement

Difficulty 3/5 1-2 days Newbie friendliness 48/100

tortoise/tortoise-orm#1924 · 3 reactions · Opened Mar 26, 2025
How to use SearchCriterio with fulltext of mysql Open

question

Difficulty 3/5 1-2 days Newbie friendliness 35/100

tortoise/tortoise-orm#1920 · 4 comments · Opened Mar 22, 2025
Tortoise queries with long JOIN aliases raise exceptions when using Postgres as the backend database Open

bug

Difficulty 4/5 3-5 days Newbie friendliness 52/100

tortoise/tortoise-orm#1902 · 2 comments · 1 reaction · Opened Feb 28, 2025
IntField: constraints not taken into account Open

enhancement

Difficulty 4/5 3-5 days Newbie friendliness 35/100

tortoise/tortoise-orm#1853 · Opened Jan 17, 2025
Which field attributes only matter for schema generation? Open

question

Difficulty 3/5 1-2 days Newbie friendliness 35/100

tortoise/tortoise-orm#1850 · 3 comments · Opened Jan 11, 2025
[Feature] Support Trio Open

enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

tortoise/tortoise-orm#1826 · 1 reaction · Opened Dec 24, 2024
Support filtering with `relation__in` using model instances Open

enhancement

Difficulty 4/5 3-5 days Newbie friendliness 38/100

tortoise/tortoise-orm#1819 · Opened Dec 19, 2024
DatetimeField Field identification error Open

oracle

Difficulty 4/5 3-5 days Newbie friendliness 30/100

tortoise/tortoise-orm#1808 · 4 comments · Opened Dec 12, 2024
on_delete should be required Open

enhancement good first issue

Difficulty 4/5 3-5 days Newbie friendliness 42/100

tortoise/tortoise-orm#1801 · 3 comments · 4 reactions · Opened Dec 5, 2024
`sql(params_inline=True)` doesn't include filter values from subqueries Open

bug

Difficulty 3/5 1-2 days Newbie friendliness 45/100

tortoise/tortoise-orm#1800 · Opened Dec 4, 2024
Use Pydantic TypeAdapter for encoding/decoding JSON fields Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

tortoise/tortoise-orm#1782 · 3 comments · Opened Nov 22, 2024
Falcon API support. Open

enhancement

Difficulty 4/5 3-5 days Newbie friendliness 35/100

tortoise/tortoise-orm#1755 · 1 comment · 1 reaction · Opened Nov 1, 2024

tortoise/tortoise-orm

Get new issues in your inbox