Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

fix(deps): require Gemini SDK lifecycle APIs (#5439)

Evoc1b510f5e927
diff --git a/docs/en/guides/01-configuration.md b/docs/en/guides/01-configuration.md
index 2f9a82af8..76f291b38 100644
--- a/docs/en/guides/01-configuration.md
+++ b/docs/en/guides/01-configuration.md
@@ -356,7 +356,7 @@ With `input: "multimodal"`, OpenViking can embed text, images (PNG, JPG, etc.),
- `voyage`: Voyage AI Embedding API
- `minimax`: MiniMax Embedding API
- `cohere`: Cohere Embedding API
-- `gemini`: Google Gemini Embedding API (text-only; requires `google-genai>=1.0.0`)
+- `gemini`: Google Gemini Embedding API (text-only; requires `google-genai>=1.39.0`)
- `dashscope`: DashScope (Alibaba Tongyi) Embedding API
- `litellm`: LiteLLM Embedding API
- `local`: Local GGUF embedding models
@@ -531,7 +531,9 @@ OpenViking also expects dense float vectors throughout storage and retrieval, so
**gemini provider example:**
-> **Note:** Requires `google-genai>=1.0.0` in the server environment — uv install: `uv tool install openviking --upgrade --with "google-genai>=1.0.0"`; pip install: `pip install "google-genai>=1.0.0"`. For async batching use the extra instead: `uv tool install "openviking[gemini-async]" --upgrade` or `pip install "openviking[gemini-async]"`.
+Version 1.39.0 is the minimum SDK version with the client context managers and close methods used to keep asynchronous embedding requests on their owning event loop. Upgrade older SDK pins before enabling this provider.
+
+> **Note:** Requires `google-genai>=1.39.0` in the server environment — uv install: `uv tool install openviking --upgrade --with "google-genai>=1.39.0"`; pip install: `pip install "google-genai>=1.39.0"`. For async batching use the extra instead: `uv tool install "openviking[gemini-async]" --upgrade` or `pip install "openviking[gemini-async]"`.
```json
{
diff --git a/docs/zh/guides/01-configuration.md b/docs/zh/guides/01-configuration.md
index 8233a2c1c..8c5dae864 100644
--- a/docs/zh/guides/01-configuration.md
+++ b/docs/zh/guides/01-configuration.md
@@ -355,7 +355,7 @@ OpenAI 已于 2026 年 8 月 31 日[停止在 ChatGPT 登录的 Codex 中提供
- `voyage`: Voyage AI Embedding API
- `minimax`: MiniMax Embedding API
- `cohere`: Cohere Embedding API
-- `gemini`: Google Gemini Embedding API(仅文本;需安装 `google-genai>=1.0.0`)
+- `gemini`: Google Gemini Embedding API(仅文本;需安装 `google-genai>=1.39.0`)
- `dashscope`: DashScope(阿里通义)Embedding API
- `litellm`: LiteLLM Embedding API
- `local`: 本地 GGUF embedding 模型
@@ -498,7 +498,9 @@ OpenAI 已于 2026 年 8 月 31 日[停止在 ChatGPT 登录的 Codex 中提供
**gemini provider 配置示例:**
-> **注意:** 需要在服务端环境安装 `google-genai>=1.0.0`——uv 安装:`uv tool install openviking --upgrade --with "google-genai>=1.0.0"`;pip 安装:`pip install "google-genai>=1.0.0"`。异步批量嵌入改用 extra:`uv tool install "openviking[gemini-async]" --upgrade` 或 `pip install "openviking[gemini-async]"`。
+SDK 1.39.0 起提供所需的客户端上下文管理器和关闭方法,用于在所属事件循环内完成异步嵌入请求及清理。启用此 provider 前,请升级固定在旧版本的 SDK。
+
+> **注意:** 需要在服务端环境安装 `google-genai>=1.39.0`——uv 安装:`uv tool install openviking --upgrade --with "google-genai>=1.39.0"`;pip 安装:`pip install "google-genai>=1.39.0"`。异步批量嵌入改用 extra:`uv tool install "openviking[gemini-async]" --upgrade` 或 `pip install "openviking[gemini-async]"`。
```json
{
diff --git a/pyproject.toml b/pyproject.toml
index 0157bb9bb..ac8237ac7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -123,10 +123,10 @@ eval = [
"pandas>=2.0.0",
]
gemini = [
- "google-genai>=1.0.0",
+ "google-genai>=1.39.0",
]
gemini-async = [
- "google-genai>=1.0.0",
+ "google-genai>=1.39.0",
"anyio>=4.0.0",
]
ocr = [
diff --git a/uv.lock b/uv.lock
index 35c01e2b3..39ca5c0d2 100644
--- a/uv.lock
+++ b/uv.lock
@@ -3600,8 +3600,8 @@ requires-dist = [
{ name = "feedparser", specifier = ">=6.0.0" },
{ name = "firecrawl-anydoc", specifier = ">=0.2.4,<0.3" },
{ name = "fusepy", marker = "extra == 'bot'", specifier = ">=3.0.1" },
- { name = "google-genai", marker = "extra == 'gemini'", specifier = ">=1.0.0" },
- { name = "google-genai", marker = "extra == 'gemini-async'", specifier = ">=1.0.0" },
+ { name = "google-genai", marker = "extra == 'gemini'", specifier = ">=1.39.0" },
+ { name = "google-genai", marker = "extra == 'gemini-async'", specifier = ">=1.39.0" },
{ name = "grep-ast", specifier = "==0.9.0" },
{ name = "html2text", marker = "extra == 'bot'", specifier = ">=2020.1.16" },
{ name = "httpx", specifier = ">=0.25.0" },