FastAPI-Cache X
A high-performance caching extension for FastAPI: a server-side response cache with Cache-Control and ETag support, and application-level caching.
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(), and@cachedfor a plain function, keyed on its arguments. - Backends — in-memory, Redis and Memcached, with atomic counters, one-shot values and locks.
Installation
uv add fastapi-cachex
Everything in the core package works with the in-memory backend. The other backends 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 |
Extras combine: uv add "fastapi-cachex[redis,memcached]".
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. Concurrent misses run
# build_report once: get_or_set() locks by default.
return await cache.get_or_set("report", build_report, ttl=300)
Documentation
The guides are built from docs/ into the site linked below. Read them there:
a code block that includes one of the runnable examples renders on the site,
while GitHub shows only its --8<-- include line (the sentence before each
block links the example file).
- Migrating to 0.5.0 — what 0.5.0 removes and how to upgrade from 0.4.x
- Migrating to 0.4.0 — what 0.4.0 changes and how to upgrade from 0.3.x
- Migrating from fastapi-cache2 — its API mapped onto this one, and the behaviour that differs
- When to use it — how it compares with fastapi-cache2, cashews, aiocache and a CDN, and when another one fits better
- 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 - 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.5.1
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.5.1.tar.gz | 86.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fastapi_cachex-0.5.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 184.1 kB
Release files / fastapi_cachex-0.5.1.tar.gz
| Download URL | fastapi_cachex-0.5.1.tar.gz |
|---|---|
| Size | 86.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c44ca5f95a02e6a266f7fd16ca26a96677ee377e0a0db021dd7d5169741acbaa
|
|
BLAKE2b-256 checksum How to use checksums |
d244419f4f6547891608a7aac85f036d5d43ec33d8bcda2f2e3b6cd3d2ebfbe9
|
| 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 Oct 15, 2026.
Transparency logRelease files / fastapi_cachex-0.5.1-py3-none-any.whl
| Download URL | fastapi_cachex-0.5.1-py3-none-any.whl |
|---|---|
| Size | 97.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
500c13116ab5375335ef1bdea422abbbb71e5a7514548b77751ccc7dd0987ea3
|
|
BLAKE2b-256 checksum How to use checksums |
2e7a15229a7160346ae5d8f3007efb0f38d5ea762b89708a06e3062e94568a0b
|
| 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 Oct 15, 2026.
Transparency log
