nyxa-cache — batteries-included cache for Nyxa

In-memory (default) and optional Redis cache for apps built with nyxa. Core nyxa does not depend on Redis.

At a glance

Install

uv add nyxa-cache
# optional Redis backend:
uv add 'nyxa-cache[redis]'

Quick start

from nyxa_cache import cache

cache.put("greeting", "hello", ttl=60)
assert cache.get("greeting") == "hello"

value = cache.remember("user:1", 120, lambda: {"id": 1})

# In async services:
user = await cache.remember_async(f"user:{item_id}", 60, lambda: load_user(item_id))

Configuration

CACHE_STORE=memory          # default
# CACHE_STORE=redis
# CACHE_REDIS_URL=redis://localhost:6379/0
# REDIS_URL=...             # fallback when CACHE_REDIS_URL unset

CLI

uv run nyxa cache clear