Installation

Requirements

• Python 3.9 or higher
• pip, poetry, or uv package manager

Install Reminiscence

pip

pip install reminiscence

poetry

poetry add reminiscence

uv

uv add reminiscence

This installs Reminiscence with all core dependencies:

• lancedb - Vector database for embeddings
• fastembed - Fast embedding generation
• orjson - Fast JSON serialization
• pyarrow - Columnar data format
• structlog - Structured logging

Optional Dependencies

For DataFrame Support

If you plan to cache pandas DataFrames or Polars DataFrames:

pip

pip install "reminiscence[dataframes]"

poetry

poetry add "reminiscence[dataframes]"

uv

uv add "reminiscence[dataframes]"

For OpenTelemetry

If you want observability and metrics:

pip

pip install "reminiscence[otel]"

poetry

poetry add "reminiscence[otel]"

uv

uv add "reminiscence[otel]"

Verify Installation

Test that Reminiscence is installed correctly:

from reminiscence import Reminiscence, ReminiscenceConfig


# Create a cache instance
cache = Reminiscence()


# Verify it works
result = cache.lookup("test query", context={})
print(f"Installation successful! Cache miss: {not result.is_hit}")

You should see: Installation successful! Cache miss: True

Development Installation

If you want to contribute or modify Reminiscence:

# Clone the repository
git clone https://github.com/demiotic/reminiscence.git
cd reminiscence

pip

pip install -e ".[dev]"
pytest

poetry

poetry install --with dev
poetry run pytest

uv

uv sync --extra dev
uv run pytest

Next Steps

Now that Reminiscence is installed, check out the Quick Start guide to learn how to use it.