Skip to main content

Fastloom – The Open Foundation for Building Event-Driven Services

Fastloom is a lightweight, batteries-included foundation for building modern backends. Define your settings, schemas, and endpoints; Fastloom wires up the rest: FastAPI, Mongo (Beanie), Rabbit (FastStream), metrics/traces/logs/errors, and more.

Think of it as the glue for your stack: web, messaging, caching, DB, observability, and integrations with best-in-class tools.


Why Fastloom

  • No boilerplate: minimal scaffolding/templating; most wiring is handled inside the library.
  • Composable: opt into only what you need via extras (fastapi, rabbit, kafka, mongo, redis, mcp, celery, openai, policy).
  • Pydantic-first: type-safe models, validators, and clear input/output contracts.
  • Multi-tenant by design: tenant context flows through DI and storage.
  • AuthN/Z via DI: OIDC token introspection and pluggable PDP (ABAC/RBAC/ReBAC) hooks.
  • Event-driven ready: publish/subscribe with routing keys and health.
  • Observability-native: metrics, traces, logs from day one.
  • Self-hostable: production parity with a cloud/aaS setup.

Integrated Services (the platform)

Fastloom plugs into a family of self-hostable services:

  • IAM → OIDC/SSO, authN/Z, RBAC/ABAC/ReBAC.
  • Notify → realtime notifications, Pusher-compatible API.
  • Pulse → user activity + event tracking with OpenTelemetry hooks.
  • File → object storage on MinIO (S3-compatible).
  • Finance, Subscription, SMS/Email, Meet, Persona → optional services you can wire in.

Each service is:

  • self-hostable (Docker Compose or Helm),
  • BaaS-available.

Quick start

# Install fastloom with the extras you need
uv add "fastloom[fastapi,mongo,rabbit]"

A minimal service is two files at the project root — settings.py and app.py — plus a tenants.yaml for defaults:

# settings.py
from fastloom.db.settings import MongoSettings
from fastloom.launcher.settings import LauncherSettings
from fastloom.observability.settings import ObservabilitySettings
from fastloom.settings.general import BaseGeneralSettings
from fastloom.signals.rabbit.settings import RabbitmqSettings


class Settings(
    BaseGeneralSettings,
    LauncherSettings,
    MongoSettings,
    RabbitmqSettings,
    ObservabilitySettings,
): ...
# app.py
from fastapi import APIRouter

from fastloom.launcher.schemas import App

from my_service import models, signals

router = APIRouter()


@router.get("/ping")
async def ping() -> dict[str, str]:
    return {"pong": "ok"}


app = App(
    routes=[(router, "", "Health")],
    models_module=models,
    signals_module=signals,
)
# tenants.yaml
default:
    ENVIRONMENT: development
    PROJECT_NAME: my_service
    MONGO_URI: mongodb://localhost:27017
    MONGO_DATABASE: my_service
    RABBIT_URI: amqp://guest:guest@localhost:5672/

Run with the bundled CLI (registered as launch via [project.scripts]):

launch

See docs/quickstart.md for a fuller walkthrough.


What you get out of the box

  • App orchestrator (fastloom.launcher)
    • Discovers your routes, models, signals, and healthchecks from app.py / settings.py
    • Exposes settings and health endpoints (public toggle via LauncherSettings.SETTINGS_PUBLIC)
  • FastAPI-native
    • Dependency-injected request/tenant context and guards
    • Clear routing, OpenAPI, and dependency injection patterns
  • Auth & Access
    • DI-based guards with OIDC / OAuth2 token introspection
    • Optional IAM sidecar for introspection + ACL
  • Multi-tenancy
    • Tenant-aware DI context across web, DB, and messaging
    • Per-tenant settings endpoint backed by DB + cache, with tenants.yaml defaults
  • Database layer (MongoDB via Beanie)
    • Created/updated mixins, pagination utilities, typed helpers
    • Auto model discovery for DB init via App.models_module
  • Signals / Messaging (Rabbit + Kafka via FastStream)
    • Rabbit: event-driven publish/subscribe with retries and DLX-based backoff
    • Kafka: subscriber/publisher wiring for consuming topics (e.g. Debezium CDC), with NACK_ON_ERROR-backed exponential backoff by default
    • Subscriber wiring and healthchecks
    • Auto-streamed BaseDocumentSignal Beanie models
  • Observability
    • OpenTelemetry distro + OTLP exporter, Logfire, Sentry (errors + profiling)
  • I18N
    • Exception handler and template utils with Babel/Jinja2
  • Healthchecks
    • Automatic app/DB/messaging/cache checks + system routes
  • MCP
    • Optional FastMCP mount with bearer auth forwarding
  • Pydantic-native schemas and validators
    • Schema In/Out validation for request/response contracts
    • Common types and validators (fastloom.types)

Dive deeper in the docs below.


Documentation


Claude Code integration

If you build services on top of fastloom and use Claude Code, you can install the fastloom-sdk plugin. It bundles:

  • Scaffolding skills — scaffold-fastloom-service, add-fastloom-route, add-rabbit-subscriber.
  • Audit skill — audit-fastloom-settings flags misuse in your settings.py / tenants.yaml.
  • Reference skill — fastloom-reference ships the full docs/ so Claude can ground its answers in the canonical documentation instead of guessing from training data.
/plugin marketplace add aradng/FastLoom
/plugin install fastloom-sdk@fastloom

Skills auto-activate from context (e.g. asking "how does fastloom auth work?" triggers fastloom-reference); explicit invocation is /fastloom-sdk:<skill-name>. The plugin is opt-in per user and doesn't ship via PyPI — it's distributed through the marketplace in this same repo.


Roadmap

  • More CLI scaffolds and blueprints.
  • Automatic pydantic-ai agentic tool creation from APIs.
  • Migrate PDP to OPAL / opa based.

Metadata

Release files for fastloom 0.5.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fastloom 0.5.11
File Size Uploaded Provenance Actions
fastloom-0.5.11.tar.gz 57.2 kB Without provenance Details for fastloom-0.5.11.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for fastloom 0.5.11
File Interpreter ABI Platform Actions
fastloom-0.5.11-py3-none-any.whl Python 3 none any Details for fastloom-0.5.11-py3-none-any.whl

Total release size: 143.6 kB

Release files / fastloom-0.5.11.tar.gz

Download URL fastloom-0.5.11.tar.gz
Size 57.2 kB
Tags Source
SHA-256 checksum
How to use checksums
d0555bb1cf8d0cf11ecc2ba4f386ec787d61604e7d3734c0fc17c1043ad53048
BLAKE2b-256 checksum
How to use checksums
195a89725583dcb50141ca920d130cf3d690eb4c5f0f6ebb39e11f0940e70f1a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / fastloom-0.5.11-py3-none-any.whl

Download URL fastloom-0.5.11-py3-none-any.whl
Size 86.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d3b698f3b5f32ac8cd2518c0a9d912c351a02eb9fe935ec4d55874d1ac23aa14
BLAKE2b-256 checksum
How to use checksums
f898803d01080c4fc302796a2cede0cbd3ee2d6df95e877bd15189c7088ac30d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for fastloom 0.5.11

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.5.11 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page