quite-admin

Version: 0.4.1 (finalized 2026-11-01) · Changelog

An embeddable admin for FastAPI and Litestar with native SQLAlchemy 2.x, SQLModel, Tortoise ORM, Peewee and GINO 1.x adapters, SQL reflection and a custom adapter API. Supports CPython 3.11–3.15. MIT licensed.

English documentation · Документация на русском

Browser demo — admin / admin. Its fictional records stay in browser storage; Reset demo restores the examples. The site workflow publishes this standalone demo alongside the documentation.

Add to an existing app in two minutes · Public API guarantees

12-second walkthrough (MP4)

Collections, fields and forms are discovered from existing SQL tables or ORM models. No additional Pydantic schemas, DTOs or ModelAdmin classes are required.

• CSV/XLSX export with column selection, filters and related-table data.
• Authenticated CRUD, automatic search, sorting and pagination; typed filters for text fragments, ranges, sets, dates, NULL and related records with name/exact-ID lookup.
• Interactive database schema and atomic stale-edit detection.
• Inline one-to-one, one-to-many and many-to-many relationship editing with atomic saves.
• Editable, read-only and hidden fields, with server-side enforcement.
• SQL reflection without model imports.
• SQLAlchemy / SQLModel, Tortoise, Peewee and GINO 1.x (gino-legacy extra) adapters; an adapter protocol for other data sources.
• Typed adapter filters/projections and delegation to application services for writes.
• Type-aware forms: TEXT textareas, date/time pickers and JSON/JSONB syntax highlighting.
• Custom pages and Jinja2 template overrides.
• Write lifecycle hooks, custom field controls and permission-checked record actions.
• English/Russian UI, configurable colors, admin name and description.
• Application-owned logging with stdlib, structlog, Loguru and Litestar backends.
• FastAPI and Litestar mounting, including nested paths and reverse-proxy prefixes.

Install

pip install 'quite-admin[sqlalchemy,fastapi]'
# Or: uv add 'quite-admin[sqlalchemy,litestar]'

Choose sqlmodel, tortoise, peewee or gino-legacy for another adapter. Use pip install quite-admin for the ORM-independent core. Native GINO requires a separate environment from SQLAlchemy 2.x. PyPI package.

Run the demo

From this source checkout:

uv sync --locked --python 3.15
QUITE_ADMIN_PASSWORD='local-demo-only' uv run uvicorn examples.fastapi_app:app --reload

Open localhost:8000/admin/ and sign in with admin / local-demo-only. For Litestar, use examples.litestar_app:app instead. The demo seeds a local SQLite database. Its HTTP cookie settings are intended for local development. Use uv 0.13.6 or newer to download a stable Python 3.15 interpreter.

Choosing an admin

The choices follow each project's documented integration boundaries. SQL reflection does not execute Python ORM hooks; select a native/service adapter when those rules matter.

Documentation

The documentation uses Diplodoc, with English as the default and a complete Russian translation. Source pages and navigation live in docs/en and docs/ru; configuration lives in docs/.yfm.

npm ci
npm run docs:build
npm run docs:serve

Requires Node.js 24+ and npm 11.5.1+. Open localhost:8001 for English or localhost:8001/ru/ for Russian. The static HTML output is written to build/docs. CI checks both translations, builds the site and uploads it as an artifact.

See integration, field configuration, GINO 1.x / PostgreSQL, relationships, language and appearance, authentication, custom pages, logging, architecture and development.

Checks

uv run pytest -q
uv run ruff check src tests examples
uv run ruff format --check src tests examples

GitHub releases provide source-code ZIP/tar.gz archives. A version tag publishes the validated GitHub release with its changelog. The separate PyPI workflow builds one wheel/sdist pair and publishes it through Trusted Publishing; Python test matrix jobs do not build distributions.

CI tests CPython 3.11, 3.12, 3.13, 3.14 and 3.15 with the pinned dependencies. The full test suite uses SQLite; PostgreSQL 17 and MySQL 8.4 have dedicated contract jobs. Separate minimum/latest dependency jobs resolve fresh isolated environments and include real SQLModel sync/async contracts. PostgreSQL/MySQL jobs run the SQLModel suite too. See the compatibility matrix and dependency endpoints for evidence, ranges and limits. SQL reflection executes database rules and triggers; Python ORM hooks require an ORM or application-service adapter. See current limitations before choosing an integration mode.