-name:Type-check (mypy)

run:mypy src

-name:Pytest

run:pytest -q --maxfail=1 --disable-warnings --cov=neuralcache --cov-report=xml

-name:Pytest (with coverage gate)

run:pytest -q --maxfail=1 --disable-warnings --cov=neuralcache --cov-report=xml --cov-fail-under=67

-name:Upload coverage artifact

uses:actions/upload-artifact@v4

- Build bootstrap hardening: enforce safe pip range excluding 25.2 (GHSA-4xh5-x5gv-qwph) and updated setuptools minimum

- CI workflow now upgrades both pip and setuptools prior to installation; pip-audit runs post-install

- Broadened dependency ranges (FastAPI, Starlette, Uvicorn) to reduce upgrade churn while retaining safety bounds

- Introduced initial coverage gate (CI fails below 67%) with plan to ratchet upward in subsequent releases

- Prevent accidental install of vulnerable pip version 25.2 by pinning`<25.2`

[](https://github.com/Maverick0351a/neuralcache/actions/workflows/codeql.yml)

[](LICENSE)

[](https://github.com/Maverick0351a/neuralcache/stargazers)

[](./coverage-policy)

NeuralCache is a lightweight reranker for RAG pipelines that*actually remembers what helped*. It blends dense semantic similarity with a narrative memory of past wins and stigmergic pheromones that reward helpful passages while decaying stale ones—then spices in MMR diversity and ε-greedy exploration. The result: more relevant context for your LLM without rebuilding your stack.

pip install -e .[dev,test]

pre-commit install

ruff check&& mypy&& pytest

ruff check&& mypy&& pytest --cov=neuralcache --cov-report=term-missing

- Look for[good first issues](https://github.com/Maverick0351a/neuralcache/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).

- Add test coverage for user-visible changes.

- Coverage gate currently enforces >=67%. We intend to ratchet this to 70%+ after adding deterministic mode & retention sweep tests.

- PRs with docs, demos, and eval improvements are extra appreciated.

Optionally, join the discussion in**#neuralcache** on Discord (coming soon—watch this space).