HTTP response caching

stare caches every GET response on disk so repeated reads of the same analysis or search query are instant after the first hit. The cache is powered by hishel (RFC 9111 HTTP cache transport) and stored as SQLite in a platform-appropriate user cache directory.

Defaults

Configuring

Set environment variables before running stare:

# Disable caching entirely
export STARE_CACHE_ENABLED=false

# Shorten the TTL to 1 hour
export STARE_CACHE_TTL_SECONDS=3600

# Use a custom directory
export STARE_CACHE_DIR=/tmp/stare-cache

Or programmatically:

from stare import Glance
from stare.settings import StareSettings

g = Glance(settings=StareSettings(cache_enabled=False))

Per-invocation bypass

Every CLI command accepts --no-cache to bypass the cache for that run:

stare analysis search -q 'referenceCode contain HION' --no-cache

Cache management

Inspect and clear the on-disk cache:

# Show cache path, TTL, and current database size
stare cache info

# Delete every cached response (prompts for confirmation when stdin is a TTY)
stare cache clear

# Non-interactive clear (CI pipelines, scripts)
stare cache clear --yes

Security

The cache directory lives under the per-user platform cache path (platformdirs.user_cache_dir("stare")), so cached responses are not shared across user accounts. Authorization headers are included in the cache key, so different tokens never share a cached response even if they hit the same URL.