Peewee 4.0 ships async, JSONField, eager-load API

Peewee 4.x adds native asyncio support via greenlets to execute_sql, unified cross-backend JSONField, and declarative relation eager-loading—enabling true async/await with FastAPI without threadpool workarounds.

July 7, 2026

Summary

Eliminates forced sync-to-async bridges (threadpools, sync_to_async serialization) that block concurrent request handling. Developers can now write fully async FastAPI apps with ORM queries that actually await cleanly on the event loop.

Why it matters

Implementation verdict

Replaces backend-specific playhouse JSON extensions and sync-only query patterns. Requires Postgres 9.2+/MySQL 8/SQLite 3.38+ and explicit AsyncPostgresqlDatabase/AsyncMysqlDatabase imports. Ready now—stable release with full FastAPI/Starlette/Quart integration patterns documented.

Sources

1.Peewee takes the query execution coroutine, switches control to the async layer and awaits it on the event loop
2.the core JSONField provides a consistent API that works across SQLite (3.38+), Postgres (jsonb), MySQL 8 and MariaDB
3.Connections in pwasyncio are task-local and maintain their own transactional state, so transactions are isolated and won't interleave across concurrently-running tasks
4.Peewee 4 is broadly compatible with the 3.x releases

Dev Signal

Get briefs like this in your inbox — free, every weekday.

100+ sources compressed into one 4-minute read. Ranked, cited, implementation-ready.

Read the full issue →All briefs