Skip to main content

Reranker API

Configure document reranking to improve result relevance.

Flag

--reranker <type>

Available Rerankers

TypeDescriptionRequirements
noneNo rerankingNone
simpleKeyword-based scoringNone (built-in)
llmLLM-based relevanceOpenAI/Anthropic API key
cross_encoderCross-encoder modelsentence-transformers
cohereCohere Rerank APICOHERE_API_KEY

Usage

No Reranking

# Skip reranking step
praisonai knowledge query "What is Python?" --reranker none

Simple Reranker (Built-in)

# Keyword-based, no external deps
praisonai knowledge query "What is Python?" --reranker simple

LLM Reranker

# Uses LLM to score relevance
export OPENAI_API_KEY=sk-xxx
praisonai knowledge query "What is Python?" --reranker llm

Cross-Encoder Reranker

# Requires sentence-transformers
pip install sentence-transformers
praisonai knowledge query "What is Python?" --reranker cross_encoder

Cohere Reranker

# Requires Cohere API key
export COHERE_API_KEY=xxx
praisonai knowledge query "What is Python?" --reranker cohere

Reranker Selection Guide

Use CaseRecommended
Fast, no dependenciessimple
Best accuracycohere or cross_encoder
Already using LLMllm
Minimal latencynone

Examples

Combining with Retrieval

# Fusion retrieval + simple reranking
praisonai knowledge query "Compare approaches" \
  --retrieval fusion \
  --reranker simple

Full Pipeline

# Complete RAG with reranking
praisonai knowledge query "Best practices for deployment" \
  --vector-store chroma \
  --retrieval fusion \
  --reranker simple \
  --query-mode default

Environment Variables

# For LLM reranker
export OPENAI_API_KEY=sk-xxx

# For Cohere reranker
export COHERE_API_KEY=xxx

See Also