tempest-fastapi-sdk

Shared FastAPI / SQLAlchemy / Pydantic building blocks used across every Tempest backend service. Start every project with the same opinionated foundation already in place.

---

What you get out of the box

Reach for the SDK when you would otherwise copy-paste these

SQLAlchemy BaseModel, abstract BaseUserModel + BaseUserTokenModel, async BaseRepository with bulk_create_values/bulk_upsert, Pydantic schemas + pagination (offset + cursor), exception envelope + handlers, settings mixins with title/description/examples, async DB / Redis / RabbitMQ / TaskIQ managers, Brazilian validators, JWT / password / email (with Jinja2 templates) / upload (pluggable Local + MinIO backends) utilities, Server-Sent Events, Web Push, Django-style admin site, bundled auth flow (signup / activate / login / reset), OAuth2/OIDC (Google/GitHub + generic), CSRF / Idempotency / BodySize / Prometheus / RateLimit middlewares, typed httpx HTTPClient with retry + circuit-breaker, MinIO/S3 (AsyncMinIOClient), an Alembic hook that reorders base columns, and a single CLI (tempest db, tempest user, tempest new, tempest generate).

Module	Exports
tempest_fastapi_sdk.admin	AdminSite, AdminModel, make_admin_router, UserModelAuthBackend
tempest_fastapi_sdk.api	register_exception_handlers, apply_cors, RequestIDMiddleware, IdempotencyMiddleware, BodySizeLimitMiddleware, CSRFMiddleware, PrometheusMiddleware, make_health_router, make_logs_router, make_prometheus_router, OAuth (GoogleOAuthClient / GitHubOAuthClient / OIDCProvider), JWT/role/permission dependencies, HardenedStaticFiles, RateLimitMiddleware, WebhookSignatureVerifier, run_server
tempest_fastapi_sdk.auth	UserAuthService, make_auth_router, schemas (SignupSchema, LoginSchema, PasswordResetRequestSchema, …)
tempest_fastapi_sdk.cache	AsyncRedisManager, @cached
tempest_fastapi_sdk.controllers	BaseController
tempest_fastapi_sdk.core	JSONFormatter, configure_logging, request-ID context, BaseStrEnum / BaseIntEnum
tempest_fastapi_sdk.db	BaseModel, BaseUserModel, BaseUserTokenModel, UserTokenPurpose, BaseRepository (with bulk_*), AsyncDatabaseManager, AlembicHelper, AuditMixin, SoftDeleteMixin, reorder_base_columns_first, compose_hooks
tempest_fastapi_sdk.exceptions	AppException hierarchy (404 / 409 / 401 / 403 / 422 / 429 / file-too-large / invalid-file-type / JWT)
tempest_fastapi_sdk.queue	AsyncBrokerManager (FastStream / RabbitMQ)
tempest_fastapi_sdk.schemas	BaseSchema, BaseResponseSchema, BasePaginationFilterSchema, BasePaginationSchema, cursor pagination
tempest_fastapi_sdk.services	BaseService
tempest_fastapi_sdk.settings	BaseAppSettings, ServerSettings, DatabaseSettings, RedisSettings, RabbitMQSettings, JWTSettings, AuthSettings, CORSSettings, EmailSettings, LogSettings, TokenSettings, UploadSettings, WebPushSettings, TaskIQSettings
tempest_fastapi_sdk.sse	EventStream, ServerSentEvent, sse_response
tempest_fastapi_sdk.storage	AsyncMinIOClient, ObjectStat
tempest_fastapi_sdk.tasks	AsyncTaskBrokerManager, AsyncTaskScheduler
tempest_fastapi_sdk.testing	test_session, test_database, in-memory SQLite helpers
tempest_fastapi_sdk.utils	PasswordUtils, JWTUtils, EmailUtils (with render_template), UploadUtils, LocalUploadStorage, MinIOUploadStorage, HTTPClient, RetryPolicy, MetricsUtils, LogUtils, AttemptThrottle, DownloadUtils, BR helpers, opaque-token helpers
tempest_fastapi_sdk.webpush	WebPushDispatcher, WebPushPayloadSchema, WebPushSubscriptionSchema

Five-minute quickstart

# 1. Install the SDK with every extra
pip install "tempest-fastapi-sdk[all]"

# 2. Scaffold a new service in the current directory
tempest new .

# 3. Sync deps + run the smoke test
uv sync
uv run pytest

What tempest new produces

my-service/
├── main.py                 # one-liner that imports run from src.server
├── pyproject.toml
├── .env.example
└── src/
    ├── server.py           # uvicorn entrypoint + module-level app
    ├── api/                # routers, dependencies, app factory
    ├── controllers/        # thin orchestration over services
    ├── services/           # business logic
    ├── schemas/            # request/response DTOs
    ├── db/
    │   ├── models/
    │   └── repositories/
    └── core/               # settings + constants + exceptions

Continue with Installation » for the per-extra walkthrough, Architecture » to understand the layering, or jump straight into the Tutorial ».

Status

Surface	State
Python	3.11 / 3.12 / 3.13 (matrix-tested in CI)
Tests	630+ pytest cases, ≥ 89 % coverage
Type-checking	mypy --strict, py.typed shipped (PEP 561)
Lint / format	ruff (check + fix + format)
Release pipeline	PyPI trusted-publishing on every vX.Y.Z tag