需通过独立用户目录、HERMES_HOME环境变量或Docker容器化实现多实例隔离;三者分别适用于强隔离、轻量级及生产级场景,确保配置、记忆与端口互不冲突。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在一台物理设备上同时运行多个独立配置的Hermes Agent实例,以实现账号隔离、模型分流或任务并行处理,则需规避默认单实例绑定机制。以下是实现多账号、多实例共存的具体操作路径:
一、使用独立用户目录隔离实例
每个Hermes Agent实例默认读写 ~/.hermes 目录下的配置、记忆与日志。通过为不同实例指定互不重叠的 HOME 路径,可完全隔绝其运行环境,避免配置冲突与记忆混杂。
1、创建专用系统用户(以 Linux 为例):
sudo adduser hermes-a
sudo adduser hermes-b
2、切换至新用户并初始化专属目录:
sudo su - hermes-a
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
3、重复步骤2,为 hermes-b 用户执行相同安装流程。
4、分别启动两个实例:
sudo su - hermes-a -c "hermes --name=agent-a"
sudo su - hermes-b -c "hermes --name=agent-b"
关键提示:每个用户目录下生成的 SOUL.md、MEMORY.md、USER.md 及 SQLite 数据库均完全独立,确保账号级数据隔离
二、手动指定配置根路径运行
Hermes 支持通过 HERMES_HOME 环境变量覆盖默认配置路径。无需新建系统用户,即可在同一账户下启动多个逻辑隔离实例,适用于轻量级多账号场景。
1、为第一个实例创建独立配置目录:
mkdir -p ~/hermes-instance-01
cp -r ~/.hermes/* ~/hermes-instance-01/ 2>/dev/null || true
2、为第二个实例创建另一套配置目录:
mkdir -p ~/hermes-instance-02
cp -r ~/.hermes/* ~/hermes-instance-02/ 2>/dev/null || true
3、启动第一个实例并绑定其配置路径:
HERMES_HOME="$HOME/hermes-instance-01" hermes --name=prod-account
4、启动第二个实例并绑定另一套配置路径:
HERMES_HOME="$HOME/hermes-instance-02" hermes --name=test-account
注意:首次启动时需分别完成 API Key 配置与模型选择,不可复用同一套百炼或通义千问密钥于多个生产环境
三、基于 Docker 容器化多实例部署
利用容器镜像封装完整运行时环境,每个容器拥有独立文件系统、端口映射与进程空间,是生产级多账号管理最健壮的方式,支持资源配额与网络策略控制。
1、拉取官方 Hermes Agent Docker 镜像:
docker pull ghcr.io/nousresearch/hermes-agent:latest
2、为实例 A 创建专属配置卷并运行:
docker volume create hermes-a-config
docker run -d --name hermes-a --mount source=hermes-a-config,target=/root/.hermes -p 8081:8080 ghcr.io/nousresearch/hermes-agent
3、为实例 B 创建另一配置卷并运行:
docker volume create hermes-b-config
docker run -d --name hermes-b --mount source=hermes-b-config,target=/root/.hermes -p 8082:8080 ghcr.io/nousresearch/hermes-agent
4、进入各容器分别完成初始化:
docker exec -it hermes-a /bin/bash -c "hermes --init"
docker exec -it hermes-b /bin/bash -c "hermes --init"
重要:两个容器必须绑定不同宿主机端口(如8081/8082),否则 WebUI 服务将因端口占用而失败


















