Installation¶

TL;DR¶

pip install tempest-fastapi-sdk

Requires Python 3.11+.

Use uv instead

uv add tempest-fastapi-sdk is faster and writes to pyproject.toml for you.

Optional extras¶

Feature-rich helpers pull in third-party dependencies that you only need when you actually use the helper. Pick the extras your service consumes:

Extra	Pulls in	Unlocks
`[auth]`	`bcrypt`, `PyJWT`	`PasswordUtils`, `JWTUtils`, bundled `UserAuthService` + `make_auth_router` flow
`[email]`	`aiosmtplib`, `jinja2`, `email-validator`	`EmailUtils` (with `render_template` + Jinja2 templates)
`[upload]`	`aiofiles`, `python-multipart`	`UploadUtils`, `DownloadUtils`, `LocalUploadStorage`
`[cache]`	`redis`	`AsyncRedisManager` + `@cached` + `RedisIdempotencyStore`
`[webpush]`	`pywebpush`, `cryptography`	`WebPushDispatcher`
`[metrics]`	`psutil`, `nvidia-ml-py`	`MetricsUtils`
`[queue]`	`faststream[rabbit]`	`AsyncBrokerManager`
`[tasks]`	`taskiq`, `taskiq-aio-pika`	`AsyncTaskBrokerManager`, `AsyncTaskScheduler`
`[admin]`	`jinja2`, `itsdangerous`	`AdminSite`, `AdminModel`, `make_admin_router`
`[minio]`	`minio`	`AsyncMinIOClient`, `MinIOUploadStorage`
`[http]`	`httpx`	`HTTPClient` + `RetryPolicy` + circuit-breaker
`[prometheus]`	`prometheus-client`	`PrometheusMiddleware`, `make_prometheus_router`, `make_prometheus_registry`
`[all]`	everything above	every helper

Subset (recommended)Everythinguv addpyproject.toml

pip install "tempest-fastapi-sdk[auth,upload,cache]"

pip install "tempest-fastapi-sdk[all]"

uv add "tempest-fastapi-sdk[auth,upload]>=0.32.0"

dependencies = [
    "tempest-fastapi-sdk[auth,upload]>=0.32.0",
]

Lazy imports

Since 0.7.1 every optional dependency is imported lazily at first instantiation, so import tempest_fastapi_sdk works even when only a subset of extras is installed. Instantiating a helper whose extra is missing raises ImportError with a clear hint pointing at the right extra.

CLI¶

The tempest CLI ships in the base install (no extra needed):

tempest --version              # show installed SDK version
tempest new                    # scaffold a layered service in cwd
tempest new myproject          # scaffold inside ./myproject
tempest generate --docker      # regenerate docker-compose.yaml from chosen extras
tempest db init                # bootstrap alembic dir (alembic.ini with no credentials)
tempest db revision -m "msg"   # autogenerate revision with the reorder hook applied
tempest db upgrade             # run upgrade to head (reads DATABASE_URL from .env)
tempest db downgrade -1        # roll back one revision
tempest db current             # show current revision
tempest db history             # revision log
tempest user create --email admin@local --admin   # `--email` required; password prompted interactively
tempest user list --admin      # list admins only (drop `--admin` to list everyone)
tempest fix                    # ruff check --fix . + ruff format .
tempest check                  # lint + fmt-check + mypy + pytest

See Recipes → CLI » for the full breakdown.

Verify the install¶

python -c "import tempest_fastapi_sdk; print(tempest_fastapi_sdk.__version__)"

Python version policy¶

Python	Status
3.13	Primary CI matrix
3.12	Supported
3.11	Supported (minimum)
3.10 and older	Not supported (uses `X \\| None` PEP 604 syntax)