litestar-auth 1.8.0

Litestar Auth

litestar-auth

Authentication and authorization for Litestar applications: registration, login, email verification, password reset, OAuth2, TOTP (2FA), route guards, and optional rate limiting—wired as a Litestar plugin with transport + strategy backends.

---

---

Documentation: https://zylvext.github.io/litestar-auth/

Install

uv add litestar-auth
# or: pip install litestar-auth

Optional extras: redis, oauth, totp, or all — see the installation guide.

Quickstart

Follow docs/quickstart.md for a minimal Bearer + JWT setup with the default SQLAlchemy user model.

Role management CLI

When your app uses LitestarAuth, provides session_maker, and exposes a relational role-capable SQLAlchemy user_model, the plugin also registers litestar roles for role-catalog and user-role administration. This operator surface is CLI-only: the HTTP API still exposes only the flat normalized user.roles contract and does not add role-management endpoints.

See docs/guides/roles_cli.md for prerequisites, command examples, and custom-model compatibility notes.

Repository

Contributing, local docs build, and verification commands are described in docs/contributing.md.