hermes agent 安装与卸载

16 阅读3分钟

1、hermes agent安装

Hermes Agent 在国内下载慢,主要是因为需要从 GitHub、PyPI、npm 等多个国外源拉取资源。

针对这个问题,有几种有效的加速方案,其中使用国内定制版安装脚本是最简单的方法。

🚀 方案一:使用国内定制版安装脚本(最简单)

这是由国内开发者制作的一键安装脚本,它将所有下载环节都替换为了国内镜像源,可以彻底解决下载慢的问题。

一键安装命令:

curl -fsSL https://raw.githubusercontent.com/itech001/theaiera/main/scripts/install-cn.sh | bash

这个脚本主要做了以下优化:

环节官方源国内镜像版
代码仓库github.comgitcode.com
Python 包pypi.org阿里云 PyPI 镜像
npm 包npmjs.org淘宝 npmmirror 镜像
Playwright浏览器Microsoft CDNnpmmirror.com 镜像

安装完成后,重新加载 shell 配置(如 source ~/.bashrc),然后运行 hermes 即可开始配置。

🛠️ 方案二:手动配置各个镜像源

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

如果你想使用官方脚本,但手动为每个环节配置国内源,可以参考下面的设置:

1. Git 克隆加速 用国内镜像站替换 GitHub 地址来克隆代码库:

# 使用 GitCode 镜像
git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git ~/.hermes/hermes-agent

# 或使用代理加速站
git clone https://ghfast.top/https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent

2. Python 包下载加速 配置 uvpip 使用国内 PyPI 镜像:

# 为 uv 设置阿里云镜像
export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/

# 或者为 pip 设置清华源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/

3. npm 包下载加速 配置 npm 使用淘宝镜像源:

npm config set registry https://registry.npmmirror.com

4. Playwright 浏览器下载加速 设置环境变量,让 Playwright 从国内镜像下载 Chromium:

export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright

2、hermes agent卸载

在 macOS 上完全卸载 Hermes,核心是清除三部分:命令本身、服务进程所有配置数据。只把应用拖进废纸篓通常会留下大量残留。

🗺️ 完全卸载清单

你可以对照下面这张清单逐项检查,确保没有残留:

类别默认路径 / 位置作用
1. 命令入口/usr/local/bin/hermes~/.local/bin/hermes这是你在终端输入的 hermes 命令,需要先删除
2. 配置文件~/.hermes/这是最重要的残留目录,存储了所有配置、记忆文件、聊天历史等
3. 代码仓库你克隆 Hermes 的目录,例如 ~/hermes-agent~/Desktop/hermes-agent如果当时是手动克隆的,这个文件夹也需要手动删除
4. 后台服务通过 launchctl 查看如果之前设置过开机自启,需要先卸载这个服务,否则可能会在终端自动重启

🛠️ 分步操作指南

按照以下步骤操作,可以确保卸载干净:

1️⃣ 停止并移除后台服务

打开终端,运行以下命令停止服务:

hermes gateway stop

如果之前配置过开机自启(launchctl),需要进一步移除:

launchctl remove com.hermes.agent

2️⃣ 运行官方卸载命令

hermes uninstall

如果提示命令不存在,可以直接进入下一步。

3️⃣ 手动清除所有残留文件和目录

这是最关键的一步,请依次运行以下命令:

# 1. 删除全局命令
sudo rm -f /usr/local/bin/hermes
# 或者如果你用的是用户级安装
rm -f ~/.local/bin/hermes

# 2. 删除主配置和数据目录 (这是残留最多的地方)
rm -rf ~/.hermes/

# 3. 如果你记得当初克隆仓库的位置,也请一并删除
# 例如: rm -rf ~/hermes-agent

4️⃣ 验证卸载是否干净

重启终端,然后运行以下命令,如果都提示 command not foundNo such file or directory,就说明卸载干净了:

hermes version
ls ~/.hermes

💡 两个重要提示

  • 关于重装:如果你只是遇到问题想重装,可以只删除 ~/.hermes/ 目录,这相当于恢复出厂设置,不用重新克隆整个仓库。
  • 数据备份~/.hermes/memory/ 目录下存有 Agent 的长期记忆,如果你不希望它忘记某些设定,请在删除前备份该目录。