Skip to content

ZeroEntropy reranker

Reorders retrieved memories using ZeroEntropy's hosted rerank API, selected via RERANKER_PROVIDER=zero_entropy. Reranking reorders retrieved memories by relevance after hybrid search.

Enable it

bash
RERANKER_PROVIDER=zero_entropy
ZEROENTROPY_API_KEY=<your-zeroentropy-key>

Configuration

VariableDefaultDescription
RERANKER_PROVIDERnoneSet to zero_entropy.
ZEROENTROPY_API_KEYnoneZeroEntropy API key sent as a bearer token.

The rerank model defaults to zerank-1.

Notes

  • Calls ZeroEntropy's hosted API at https://api.zeroentropy.dev/v1/models/rerank; requires network access and a valid key.
  • If ZEROENTROPY_API_KEY is unset, a warning is logged at init and rerank calls fail at runtime.
  • Response parsing assumes a Cohere-style {"results": [{"index", "relevance_score"}]} contract.

The memory layer for AI agents.