From cecc2a25c659bbcc0ba5c57fc5da35d6b46c1ea7 Mon Sep 17 00:00:00 2001
From: "Victor M. SMITH" <72023257+MVS-source@users.noreply.github.com>
Date: Tue, 21 Jul 2026 17:06:05 +0200
Subject: [PATCH] docs(config): document Eden AI as an EU OpenAI-compatible
 provider

Eden AI is a French, EU-based OpenAI-compatible gateway. OpenKB already
supports it through the existing OPENAI_API_BASE override, so this documents
the config in the configuration guide and .env.example: set LLM_API_KEY to
an Eden AI key, OPENAI_API_BASE to https://api.edenai.run/v3 (or the EU
endpoint), and a double-prefixed model (openai/<vendor>/<model>) so LiteLLM
keeps Eden AI's vendor-prefixed id intact.
---
 .env.example                     |  3 +++
 examples/configuration/README.md | 23 +++++++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/.env.example b/.env.example
index e0068c1f..69e666cd 100644
--- a/.env.example
+++ b/.env.example
@@ -7,6 +7,9 @@ LLM_API_KEY=your-key-here
 
 # Optional base URL override for OpenAI-compatible gateways
 # OPENAI_API_BASE=https://api.deepseek.com
+# Eden AI (EU-based, OpenAI-compatible, zero data retention): OPENAI_API_BASE=https://api.edenai.run/v3
+#   (or https://api.eu.edenai.run/v3 for EU data residency); then set
+#   model: openai/<vendor>/<model>, e.g. openai/openai/gpt-4o-mini
 
 # --- REST API server variables (read by `openkb-api` / `python -m openkb.api`) ---
 # OPENKB_API_TOKEN=...   # required bearer token clients send as Authorization: Bearer <token>
diff --git a/examples/configuration/README.md b/examples/configuration/README.md
index 25e5b3a8..590865ac 100644
--- a/examples/configuration/README.md
+++ b/examples/configuration/README.md
@@ -216,6 +216,29 @@ LLM_API_KEY=your-key-here
                               # Write it as bare `null` — not `None` or "null".
   ```
 
+- **Eden AI** (`OPENAI_API_BASE=https://api.edenai.run/v3`) is a French, EU-based
+  OpenAI-compatible gateway. Set `LLM_API_KEY` to your Eden AI key, point
+  `OPENAI_API_BASE` at Eden AI, and use a double-prefixed `model` so LiteLLM
+  keeps Eden AI's vendor-prefixed id intact:
+
+  ```bash
+  # <kb>/.env
+  LLM_API_KEY=your-edenai-key
+  OPENAI_API_BASE=https://api.edenai.run/v3   # or https://api.eu.edenai.run/v3 for EU data residency
+  ```
+
+  ```yaml
+  # <kb>/.openkb/config.yaml
+  model: openai/openai/gpt-4o-mini   # openai/<vendor>/<model>, e.g. openai/anthropic/claude-sonnet-4-5
+  ```
+
+  The leading `openai/` selects LiteLLM's OpenAI-compatible transport (so it uses
+  `OPENAI_API_BASE`); the remaining `<vendor>/<model>` is Eden AI's model id. Eden
+  AI's EU endpoint processes and routes prompts and outputs within the European
+  Union, with zero data retention by default (SOC 2 / ISO 27001, DPA as standard),
+  which is useful for GDPR-sensitive knowledge bases. See
+  https://www.edenai.co/data-compliancy.
+
 **Where keys are read from** (first match wins, existing env always respected):
 
 1. your shell environment