From 0fec4d9169b304e7844e6b405a31e759c78824d6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=B3n=20Levy?= <levy@andes.is>
Date: Wed, 10 Sep 2025 15:16:06 +0000
Subject: [PATCH] feat: add COHERE_BASE_URL configuration for custom Cohere
 endpoints
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add COHERE_BASE_URL environment variable to dotenv documentation
- Update web search features documentation with custom endpoint option
- Add cohereApiUrl parameter to YAML configuration reference
- Enables use of custom Cohere endpoints or LiteLLM proxies for reranking

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 pages/docs/configuration/dotenv.mdx                   |  1 +
 .../librechat_yaml/object_structure/web_search.mdx    | 11 +++++++++++
 pages/docs/features/web_search.mdx                    |  1 +
 3 files changed, 13 insertions(+)

diff --git a/pages/docs/configuration/dotenv.mdx b/pages/docs/configuration/dotenv.mdx
index 22bdb8d38..927b70076 100644
--- a/pages/docs/configuration/dotenv.mdx
+++ b/pages/docs/configuration/dotenv.mdx
@@ -288,6 +288,7 @@ For detailed configuration and customization options, see: [Web Search Configura
     ['FIRECRAWL_API_URL', 'string', 'Custom Firecrawl API URL (optional). Only needed for custom Firecrawl instances.', '# FIRECRAWL_API_URL='],
     ['JINA_API_KEY', 'string', 'API key for Jina reranker service. Get your key from https://jina.ai/api-dashboard/', '# JINA_API_KEY='],
     ['COHERE_API_KEY', 'string', 'API key for Cohere reranker service. Get your key from https://dashboard.cohere.com/welcome/login', '# COHERE_API_KEY='],
+    ['COHERE_BASE_URL', 'string', 'Custom Cohere API base URL (optional). Only needed for custom Cohere endpoints or proxies.', '# COHERE_BASE_URL='],
   ]}
 />
 
diff --git a/pages/docs/configuration/librechat_yaml/object_structure/web_search.mdx b/pages/docs/configuration/librechat_yaml/object_structure/web_search.mdx
index 5ece6555b..9912cba76 100644
--- a/pages/docs/configuration/librechat_yaml/object_structure/web_search.mdx
+++ b/pages/docs/configuration/librechat_yaml/object_structure/web_search.mdx
@@ -28,6 +28,7 @@ webSearch:
   # Reranker Configuration
   jinaApiKey: "${JINA_API_KEY}"
   cohereApiKey: "${COHERE_API_KEY}"
+  cohereApiUrl: "${COHERE_BASE_URL}"
   rerankerType: "jina" # Options: "jina", "cohere"
 
   # General Settings
@@ -295,6 +296,16 @@ webSearch:
 
 **Note:** Get your API key from [Cohere Dashboard](https://dashboard.cohere.com/welcome/login)
 
+### cohereApiUrl
+
+<OptionTable
+  options={[
+    ['cohereApiUrl', 'String', 'Environment variable name for the Cohere API base URL. If not set in .env, users will be prompted to provide it via UI.', '${COHERE_BASE_URL}'],
+  ]}
+/>
+
+**Note:** This is optional and only needed if you're using a custom Cohere endpoint or proxy.
+
 ### rerankerType
 
 <OptionTable
diff --git a/pages/docs/features/web_search.mdx b/pages/docs/features/web_search.mdx
index 46a62df44..2c371c6f0 100644
--- a/pages/docs/features/web_search.mdx
+++ b/pages/docs/features/web_search.mdx
@@ -71,6 +71,7 @@ Each component of the web search feature requires its own API key. Here's how to
 3. Navigate to the API Keys section
 4. Copy your API key
 5. Set it in your environment variables or provide it through the UI
+6. (Optional) Set `COHERE_BASE_URL` if using a custom Cohere endpoint or proxy
 
 ## Components