FastAPI-Cache X
A high-performance caching extension for FastAPI: a server-side response cache with Cache-Control and ETag support, application-level caching, and optional session management.
Documentation: https://fastapi-cachex.readthedocs.io/en/latest/ — guides and the full API reference.
Features
- HTTP caching — a
@cachedecorator for GET routes withCache-Control,ETag/If-None-Match(304) and per-route invalidation. - Application cache —
CacheManagerfor caching arbitrary JSON values in your own code, with compute-on-missget_or_set()and atomic store-if-absentadd(). - Backends — in-memory, Redis and Memcached, with atomic counters, one-shot values and locks.
- Sessions (optional) — HMAC-signed or JWT session tokens over headers, bearer tokens or cookies, with sliding expiration and IP/User-Agent binding.
- OAuth state — one-time state tokens for CSRF protection in OAuth/OIDC flows.
Installation
uv add fastapi-cachex
Everything in the core package works with the in-memory backend. The other backends and the optional session transports ship as extras:
| Extra | Install | Pulls in | Needed for |
|---|---|---|---|
redis |
uv add "fastapi-cachex[redis]" |
redis[hiredis], orjson |
AsyncRedisCacheBackend |
memcached |
uv add "fastapi-cachex[memcached]" |
pymemcache |
MemcachedBackend (the older memcache name still works until 0.4.0) |
jwt |
uv add "fastapi-cachex[jwt]" |
PyJWT |
SessionConfig(token_format="jwt") |
Extras combine: uv add "fastapi-cachex[redis,jwt]".
Quick Start
from fastapi import FastAPI
from fastapi_cachex import AppCache, BackendProxy, cache
from fastapi_cachex.backends import MemoryBackend
app = FastAPI()
BackendProxy.set(MemoryBackend()) # or AsyncRedisCacheBackend / MemcachedBackend
@app.get("/items/{item_id}")
@cache(ttl=60) # served from the cache for 60 seconds, with ETag revalidation
async def read_item(item_id: int):
return {"item_id": item_id}
def build_report() -> dict:
return {"total": 42} # stands in for something slow
@app.get("/report")
async def report(cache: AppCache):
# Cache any JSON value in your own code. lock=True runs build_report once
# for concurrent misses (the default from 0.4.0).
return await cache.get_or_set("report", build_report, ttl=300, lock=True)
Documentation
- Migrating to 0.4.0 — what 0.4.0 changes and how to act on the 0.3.9 warnings now
- HTTP caching — the
@cachedecorator, Cache-Control directives, cache keys, invalidation and monitoring routes - Application cache —
CacheManager - Backends — choosing and configuring a backend, atomic primitives
- Distributed lock —
CacheLockfor multi-process mutual exclusion - Session management, OAuth state (one-shot OAuth/CSRF state tokens) and JWT claims
- Cache flow — what happens inside a cached request
- Runnable examples — one complete app per feature, each covered by the test suite
- API reference
- Development guide and contributing · Security policy — report vulnerabilities privately, not in public issues
- Changelog · Known limitations and planned work
License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
1 maintainer
Metadata
1 maintainer
Release files for fastapi-cachex 0.3.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fastapi_cachex-0.3.9.tar.gz | 95.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fastapi_cachex-0.3.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 205.6 kB
Release files / fastapi_cachex-0.3.9.tar.gz
| Download URL | fastapi_cachex-0.3.9.tar.gz |
|---|---|
| Size | 95.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
955ab23b20c0e6dc3413aa3ee4d80b34c6d472ec05b4fed3a668754a98af83c2
|
|
BLAKE2b-256 checksum How to use checksums |
c2b307e79a5d20213b2b5727e6d53604ed886d30aee92d3157078d422b782ca2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.
Transparency logRelease files / fastapi_cachex-0.3.9-py3-none-any.whl
| Download URL | fastapi_cachex-0.3.9-py3-none-any.whl |
|---|---|
| Size | 110.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2022f30bb2cb91868db14a5522fb7f80aa248669a2bfca0cebccc6933158638d
|
|
BLAKE2b-256 checksum How to use checksums |
1a8c26f1955ed4a72c4ba270ef200be86dda2c03230ab0ba4b12a36812b806ba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 29, 2026.
Transparency log
