feat: replace Jina reranker with custom reranker support in configuration

docker-compose.librechat.yml

@@ -108,8 +108,9 @@ services:
       SCALEWAY_APP_NAME: ${SCALEWAY_APP_NAME:-LibreChat}
       LIBRECHAT_SEARXNG_URL: ${LIBRECHAT_SEARXNG_URL:-http://${STACK_NAME:-prod}-searxng:8080}
       LIBRECHAT_SEARXNG_API_KEY: ${LIBRECHAT_SEARXNG_API_KEY:-}
-      LIBRECHAT_JINA_API_KEY: ${LIBRECHAT_JINA_API_KEY:-}
-      LIBRECHAT_JINA_API_URL: ${LIBRECHAT_JINA_API_URL:-https://api.jina.ai/v1/rerank}
+      LIBRECHAT_CUSTOM_RERANKER_API_URL: ${LIBRECHAT_CUSTOM_RERANKER_API_URL:-}
+      LIBRECHAT_CUSTOM_RERANKER_API_KEY: ${LIBRECHAT_CUSTOM_RERANKER_API_KEY:-}
+      LIBRECHAT_CUSTOM_RERANKER_MODEL: ${LIBRECHAT_CUSTOM_RERANKER_MODEL:-}
       FIRECRAWL_API_KEY: ${FIRECRAWL_API_KEY:-local-selfhost}
       FIRECRAWL_API_URL: ${FIRECRAWL_API_URL:-http://${STACK_NAME:-prod}-firecrawl-api:3002}
       FIRECRAWL_VERSION: ${FIRECRAWL_VERSION:-v2}

docs/TODO.md

@@ -131,6 +131,7 @@
 | Open | `fix/mcp-parser` | [#12103](https://github.com/danny-avila/LibreChat/pull/12103) | Auto-detect OpenAI-compatible custom endpoints in formatToolContent |
 | Open | `feat/stt` | [#11528](https://github.com/danny-avila/LibreChat/pull/11528) | Prefer ogg/wav in external STT recording for backend compatibility |
 | Waiting | — | depends on [#10574](https://github.com/danny-avila/LibreChat/pull/10574) | Replace Jina reranker with RAG API reranker (`rerankerType: "simple"`) |
+| Open | `feat/custom-reranker-provider` | [#12121](https://github.com/danny-avila/LibreChat/pull/12121) | Add custom reranker provider support (configurable URL + model, e.g. Scaleway) — depends on [agents#66](https://github.com/danny-avila/agents/pull/66) |
 
 ### danny-avila/agents
 
@@ -139,6 +140,7 @@
 | Draft | — | [#48](https://github.com/danny-avila/agents/pull/48) | Filter base64 image artifacts based on agent vision capability |
 | Open | `fix/user-after-tool` | [#59](https://github.com/danny-avila/agents/pull/59) | Fix "400 Unexpected role 'user' after role 'tool'" (bridge AIMessage in `formatAgentMessages`) |
 | Open | `fix/wrong-agent-id` | [#61](https://github.com/danny-avila/agents/pull/61) | Fix handoff: return wrong-tool correction to LLM instead of silent execute |
+| Open | `feat/custom-reranker-provider` | [#66](https://github.com/danny-avila/agents/pull/66) | Add custom reranker provider with configurable URL and model name |
 
 ### arabold/docs-mcp-server
 

env.local.example

@@ -138,9 +138,11 @@ FIRECRAWL_VERSION=v2
 FIRECRAWL_NUM_WORKERS=8
 FIRECRAWL_BULL_AUTH_KEY=my-secret-key
 FIRECRAWL_LLM_MODEL=gpt-4o
-# Jina Reranker (for LibreChat WebSearch)
-LIBRECHAT_JINA_API_KEY=
-LIBRECHAT_JINA_API_URL=https://api.jina.ai/v1/rerank
+
+# Custom Reranker (for LibreChat WebSearch, using Scaleway Generative APIs)
+LIBRECHAT_CUSTOM_RERANKER_API_URL=${SCALEWAY_BASE_URL}/rerank
+LIBRECHAT_CUSTOM_RERANKER_API_KEY=${SCALEWAY_API_KEY}
+LIBRECHAT_CUSTOM_RERANKER_MODEL=qwen3-embedding-8b
 
 # SearXNG - Springer Nature API (optional, for scientific literature search)
 # Get your API key from: https://dev.springernature.com/

packages/librechat-init/config/librechat.yaml

@@ -809,9 +809,10 @@ webSearch:
   firecrawlApiKey: "$${FIRECRAWL_API_KEY}"
   firecrawlApiUrl: "$${FIRECRAWL_API_URL}"
   firecrawlVersion: "$${FIRECRAWL_VERSION}"
-  jinaApiKey: "$${LIBRECHAT_JINA_API_KEY}"
-  jinaApiUrl: "$${LIBRECHAT_JINA_API_URL}"
-  rerankerType: "jina"
+  customRerankerApiUrl: "$${LIBRECHAT_CUSTOM_RERANKER_API_URL}"
+  customRerankerApiKey: "$${LIBRECHAT_CUSTOM_RERANKER_API_KEY}"
+  customRerankerModel: "$${LIBRECHAT_CUSTOM_RERANKER_MODEL}"
+  rerankerType: "custom"
   scraperTimeout: 7500
   safeSearch: 1
 

scripts/setup-env.ts

@@ -201,7 +201,6 @@ const PROMPTS: Record<string, PromptConfig> = {
     'GID': { message: 'Docker Host Group ID (GID):', type: 'input', defaultGen: () => '1000' },
     'DOMAIN': { message: 'Domain or IP (e.g. localhost or ai.faktenforum.org):', type: 'input' },
     'OPENROUTER_KEY': { message: 'OpenRouter API Key:', type: 'password' },
-    'LIBRECHAT_JINA_API_KEY': { message: 'Jina API Key (optional, press enter to skip):', type: 'input' },
     'LIBRECHAT_OCR_API_KEY': { message: 'Mistral OCR API Key (optional, press enter to skip):', type: 'password' },
 
     // DB Timetable MCP Server
@@ -260,6 +259,8 @@ const MIGRATIONS: Record<string, string> = {
     'SEARXNG_API_KEY': 'LIBRECHAT_SEARXNG_API_KEY',
     'JINA_API_KEY': 'LIBRECHAT_JINA_API_KEY',
     'JINA_API_URL': 'LIBRECHAT_JINA_API_URL',
+    'LIBRECHAT_JINA_API_KEY': 'LIBRECHAT_CUSTOM_RERANKER_API_KEY',
+    'LIBRECHAT_JINA_API_URL': 'LIBRECHAT_CUSTOM_RERANKER_API_URL',
     'USE_DB_AUTHENTICATION': 'FIRECRAWL_USE_DB_AUTHENTICATION',
     'PLAYWRIGHT_MICROSERVICE_URL': 'FIRECRAWL_PLAYWRIGHT_MICROSERVICE_URL',
     'WEBHOOK_URL': 'N8N_WEBHOOK_URL',