simple_module_pythonA modular monolith for Python

FastAPI + SQLModel + Inertia.js + React. Plugin modules that compose at boot. No microservice tax, no API-client glue.

Build with it

Five-minute quickstart, then scaffold your first module. You'll learn the loop — add a model, generate a migration, write a service, mount a page.

Quickstart

Author a module

Read the framework conventions, then walk through a real module end-to-end. Models, contracts, service, endpoints, pages, tests, locales.

Build a module

Use a bundled module

Ten first-party modules ship with the framework — auth, users, keycloak, permissions, settings, file_storage, background_tasks, feature_flags, audit_log, dashboard.

Browse modules

Operate it in production

Deployment, environment variables, diagnostics, release pipeline, performance + load testing.

Deploy

How the docs are organised

Guide

Install, bootstrap, and build your first module.

Framework

Discovery, lifecycle hooks, middleware, permissions, events, i18n.

Database

SQLModel conventions, per-module Base, mixins, sessions, Alembic.

Frontend

Inertia page keys, shared props, page discovery, React layout.

Testing

The simple_module_test plugin fixtures, unit tests, end-to-end tests.

Modules

Reference for each bundled module: routes, contracts, settings.

Reference

CLI commands, env vars, diagnostic codes, deployment.

Try it in 60 seconds

bash

uv tool install simple_module_cli
smpy new myapp --yes
cd myapp
make dev          # API on :8000, Vite on :5050

Then in another terminal, inside myapp: