Authentication and authorization for modern Python applications.
NeoZen (NeoZeN = AuthN + AuthZ) is a framework-agnostic authentication and authorization toolkit for Python. It is also, secondarily, a lightweight self-hostable identity provider you can stand up in front of one or more apps.
Status: 0.9 is the first public release. Docs, tests, packaging and the reference deployment are in good shape, but 0.9 is not yet semver-stable: the API may evolve before 1.0.
pip install neozen and embed it in your own Litestar, Starlette, Flask, or other Python web app. Bring your own User model. Pick the factors and storage backend you need.
pip install "neozen[sqlalchemy,password]"See the Developer Quickstart: a runnable 80-line Litestar app in under five minutes.
docker compose up -d to run NeoZen as its own IAM service with an admin console. Other apps talk to it over standard protocols.
cd deploy/docker
docker compose up -d
docker compose logs neozen | grep NEOZEN-BOOTSTRAP-CREDENTIALS -A 6See the Self-Hosted Quickstart: a working self-hosted IAM in under ten minutes.
- Authentication: passwords (Argon2id), magic links, TOTP, email OTP, WebAuthn/passkeys, social login (Google, GitHub)
- Authorization: role-based access control (RBAC), permissions, policy-based authorization
- OAuth 2.1 server: authorization code with PKCE, refresh, client credentials
- OpenID Connect 1.0 Provider: discovery, JWKS, ID tokens, UserInfo, consent, RP-initiated logout, dynamic client registration
- SCIM 2.0 server: User and Group resources with filter parser
- LDAP backend: read-mostly LDAP/Active Directory with bind-based password authentication
- Sessions, groups, invitations, rate limiting, account lockout, audit logging, i18n
- Framework adapters for Flask, Litestar, Starlette
- Admin console (Litestar) with user management, bulk import/export, live audit log, security dashboard
- Reference deployment: Dockerfile, docker-compose, starter Helm chart,
neozen serveproduction-mode CLI
- Framework-agnostic: works with Flask, Litestar, Starlette, or any WSGI/ASGI app
- Protocol-based: depend on interfaces, not implementations
- Bring Your Own Model: factory functions and split protocols let you plug your own User model without inheriting from NeoZen base classes
- Secure by default: Argon2id hashing, timing-safe comparison, rate limiting, account lockout, audit logging
- Modular: use only the components you need
- Type-checked across mypy, ty, and pyrefly
Full docs at https://neozen.lab.abilian.com/ (or build locally with make -C docs serve).
# Clone
git clone https://git.sr.ht/~sfermigier/neozen
cd neozen
# Install with all extras
uv sync --all-extras
# Run the full test suite
uv run pytest tests/a_unit tests/b_integration tests/c_e2e
# Lint
uv run ruff check
# Build the docs
make -C docs serveApache License 2.0. See LICENSE.
NeoZen is sponsored by Abilian SAS. Abilian's interest in NeoZen is in consulting and integration services around the OSS, not in a product upsell. There is no paid tier and no open-core gating.