完全卸载hermes agent需同步清理运行环境、配置与残留数据:一、执行官方卸载脚本(推荐);二、手动逐层清理(含进程、目录、path配置);三、termux安卓专用清理;四、docker/vps专项清理;五、验证命令失效、目录空、无二进制文件及环境变量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已安装 Hermes Agent 并希望完全移除其所有组件、配置与残留数据,则需同步清理运行环境、用户目录、系统级依赖及权限配置。以下是彻底卸载的多种方法:
一、执行官方卸载脚本(推荐首选)
该方式由 Hermes Agent 项目维护者提供,可自动识别并清除核心安装路径、虚拟环境、shell 配置项及全局命令别名。
1、打开终端(Linux/macOS)或 WSL2 终端(Windows),确保当前用户具有 ~/.hermes/ 目录读写权限。
2、运行官方卸载命令:curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/uninstall.sh | bash。
3、脚本将提示确认删除 ~/.hermes/、~/.local/bin/hermes、Python 虚拟环境路径及 ~/.bashrc 或 ~/.zshrc 中的 hermes 初始化行。
4、按提示输入 y 确认执行,完成后脚本自动退出。
二、手动逐层清理(适用于脚本失效或定制化部署场景)
当使用 Docker、自定义路径安装或未通过 install.sh 部署时,需人工定位并删除全部关联文件与进程。
1、终止所有 Hermes 相关进程:pkill -f 'hermes' && pkill -f 'honcho' && pkill -f 'gateway'。
2、删除主安装目录:rm -rf ~/.hermes。
3、清除全局可执行文件:rm -f ~/.local/bin/hermes ~/.local/bin/hermes-gateway ~/.local/bin/skill_manage。
4、编辑 shell 配置文件:nano ~/.bashrc 或 nano ~/.zshrc,删除包含 source ~/.hermes/env.sh 或 export PATH=~/.hermes/bin:$PATH 的整行。
5、重新加载配置:source ~/.bashrc 或 source ~/.zshrc。
三、清理 Termux 环境(安卓设备专用)
在 Android 设备上通过 Termux 部署的 Hermes Agent 需单独处理其沙箱路径与包管理残留。
1、启动 Termux 应用,执行:pkg uninstall ffmpeg nodejs python ripgrep(仅卸载 Hermes 显式依赖,保留基础工具)。
2、删除 Hermes 用户空间:rm -rf $HOME/.hermes。
3、检查并清理自动启动脚本:ls -la $PREFIX/etc/profile.d/ | grep hermes,若存在则执行 rm $PREFIX/etc/profile.d/hermes.sh。
4、清空 Termux 缓存:pkg clean。
四、VPS 或 Docker 部署环境专项清理
针对使用 Contabo VPS、Docker 或 docker-compose 部署的实例,需额外清除容器、镜像、卷与定时任务。
1、停止并删除容器:docker stop hermes-agent && docker rm hermes-agent。
2、删除构建镜像:docker rmi $(docker images | grep 'hermes-agent' | awk '{print $3}')。
3、清除持久化卷:docker volume rm hermes-data hermes-skills hermes-memories。
4、检查 crontab 是否存在 Hermes 定时任务:crontab -l | grep hermes,若有则执行 crontab -e 并手动删除对应行。
五、验证卸载完整性
执行以下操作确认 Hermes Agent 及其痕迹是否已完全消失,避免残留影响后续部署或系统稳定性。
1、检查命令是否失效:hermes --version,应返回 command not found。
2、确认主目录无残留:ls -la ~ | grep '.hermes',输出应为空。
3、搜索系统级二进制文件:find /usr -name 'hermes*' 2>/dev/null 与 find ~/.local -name 'hermes*' 2>/dev/null,均不应返回任何路径。
4、检查环境变量:env | grep -i hermes,输出应为空。











