simple-module-users 0.0.17

Email + password user management, admin invites, RBAC-ready — replaces Keycloak for simple_module apps

simple_module_users

Email+password user management for simple_module apps. Replaces Keycloak/Auth0 for the common case: local accounts, admin invites, password reset, optional public signup. Built on fastapi-users.

Install

pip install simple_module_users

Pre-wired into any app scaffolded with smpy new.

What it provides

• Email + password registration, login, logout, password reset.
• Admin invite flow — admin enters an email, recipient clicks a link, sets a password, is logged in.
• Public signup toggle (SM_USERS_ALLOW_SIGNUP, default false).
• Bootstrap admin via env vars (SM_USERS_BOOTSTRAP_EMAIL + SM_USERS_BOOTSTRAP_PASSWORD) — idempotent, only creates if the users table is empty.
• smpy users create-admin CLI for ad-hoc admin creation.
• Inertia pages for login/register/invite-accept/admin-invite.
• Console mailer (logs to stdout) or SMTP mailer (SM_USERS_MAILER=smtp).

Usage

CLI:

uv run smpy users create-admin --email [e-mail] --password 'change-me'

Bootstrap-on-boot (.env):

SM_USERS_BOOTSTRAP_EMAIL=[e-mail]
SM_USERS_BOOTSTRAP_PASSWORD=change-me

Program:

from users.deps import CurrentUser    # type: ignore[import-not-found]

@router.get("/profile")
async def profile(user: CurrentUser):
    return {"email": user.email}

Depends on

• simple_module_core, simple_module_db, simple_module_hosting, simple_module_auth
• fastapi-users[sqlalchemy]>=15,<16, aiosmtplib, cachetools, typer

License

MIT — see LICENSE.