Skip to content

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

docs: isolate OpenViking installs for Hermes (#3365)

huangruiteng810a22d8818a
diff --git a/docs/en/agent-integrations/05-hermes.md b/docs/en/agent-integrations/05-hermes.md
index 85a8b6cea..65d967b81 100644
--- a/docs/en/agent-integrations/05-hermes.md
+++ b/docs/en/agent-integrations/05-hermes.md
@@ -2,6 +2,17 @@
[Hermes Agent](https://hermes-agent.nousresearch.com/) by Nous Research has a first-class OpenViking memory provider built in. No plugin to install — just point Hermes at your OpenViking server and it handles memory storage, recall, and extraction natively.
+## Keep the Python environments separate
+
+Hermes connects to OpenViking over HTTP, so OpenViking does not need to be
+installed in the Hermes Python environment. Run the OpenViking server in its
+own virtual environment or container. Do not use `--force-reinstall` to add or
+upgrade OpenViking in an existing Hermes environment: a Hermes release may pin
+dependency versions that differ from OpenViking's supported, security-patched
+versions. If you intentionally combine both applications in one environment,
+resolve them together and run `python -m pip check` before starting either
+service.
+
## Setup
Run the Hermes memory setup wizard:
diff --git a/docs/zh/agent-integrations/05-hermes.md b/docs/zh/agent-integrations/05-hermes.md
index 8a13257b8..20d4d94e2 100644
--- a/docs/zh/agent-integrations/05-hermes.md
+++ b/docs/zh/agent-integrations/05-hermes.md
@@ -2,6 +2,15 @@
[Hermes Agent](https://hermes-agent.nousresearch.com/) (Nous Research) 内置 OpenViking 记忆提供方。无需安装插件——把 Hermes 指向你的 OpenViking 服务即可,记忆存储、召回和抽取均原生支持。
+## 隔离 Python 环境
+
+Hermes 通过 HTTP 连接 OpenViking,因此无需把 OpenViking 安装到 Hermes 的
+Python 环境中。请在独立的虚拟环境或容器中运行 OpenViking 服务。不要在
+已有 Hermes 的环境中使用 `--force-reinstall` 安装或升级 OpenViking:Hermes
+版本可能会固定与 OpenViking 已支持、已修复安全问题的版本不同的依赖。如果确实要将
+两个应用放在同一环境中,请在同一次依赖求解中安装它们,并在启动任一服务前运行
+`python -m pip check`。
+
## 配置
运行 Hermes 记忆配置向导: