1、hermes agent安装
Hermes Agent 在国内下载慢,主要是因为需要从 GitHub、PyPI、npm 等多个国外源拉取资源。
针对这个问题,有几种有效的加速方案,其中使用国内定制版安装脚本是最简单的方法。
🚀 方案一:使用国内定制版安装脚本(最简单)
这是由国内开发者制作的一键安装脚本,它将所有下载环节都替换为了国内镜像源,可以彻底解决下载慢的问题。
一键安装命令:
curl -fsSL https://raw.githubusercontent.com/itech001/theaiera/main/scripts/install-cn.sh | bash
这个脚本主要做了以下优化:
| 环节 | 官方源 | 国内镜像版 |
|---|---|---|
| 代码仓库 | github.com | gitcode.com |
| Python 包 | pypi.org | 阿里云 PyPI 镜像 |
| npm 包 | npmjs.org | 淘宝 npmmirror 镜像 |
| Playwright浏览器 | Microsoft CDN | npmmirror.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 包下载加速
配置 uv 或 pip 使用国内 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 found 或 No such file or directory,就说明卸载干净了:
hermes version
ls ~/.hermes
💡 两个重要提示
- 关于重装:如果你只是遇到问题想重装,可以只删除
~/.hermes/目录,这相当于恢复出厂设置,不用重新克隆整个仓库。 - 数据备份:
~/.hermes/memory/目录下存有 Agent 的长期记忆,如果你不希望它忘记某些设定,请在删除前备份该目录。