// the find
nsidnev/fastapi-realworld-example-app
Backend logic implementation for https://github.com/gothinkster/realworld with awesome FastAPI
A FastAPI implementation of the RealWorld (Conduit) spec — a medium.com clone backend with users, articles, comments, tags, and follows. It's explicitly archived; the author says it's done and won't be maintained. Good as a reference for how a mid-sized async FastAPI app can be structured, not as a starting point for production work.
Clean separation between domain models and API schemas — the models/domain vs models/schemas split keeps validation logic from leaking into business objects. Raw SQL via aiosql rather than an ORM gives you readable, auditable queries in .sql files instead of magic. 90 passing tests with good route coverage and a fake asyncpg pool for unit tests without spinning up Postgres. GitHub Actions CI that runs the actual Conduit API test suite against a real database, not just your own assertions.
Frozen in 2022 — asyncpg has since been largely superseded by psycopg3 as the preferred async Postgres driver, and several FastAPI patterns here (app startup events, older dependency injection style) have been replaced by cleaner idioms. The single Alembic migration file means all schema is in one blob with no incremental history — you can't trace when a column was added or why. No pagination on article listing beyond what the spec requires, so it's a toy dataset implementation. Python 3.8-era type hints throughout; won't take advantage of the syntax improvements in 3.10+.