Skip to content
abilianPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

NeoZen

Authentication and authorization for modern Python applications.

License: Apache 2.0 Python 3.12+

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.

Two ways to use NeoZen

As a library

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.

As a self-hosted service

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 6

See the Self-Hosted Quickstart: a working self-hosted IAM in under ten minutes.

What NeoZen provides

  • 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 serve production-mode CLI

Design principles

  • 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

Documentation

Full docs at https://neozen.lab.abilian.com/ (or build locally with make -C docs serve).

Development

# 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 serve

License

Apache 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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages