Hermes Agent 彻底卸载需五步：一、停止进程并清运行时目录；二、删除 ~/.hermes/ 及 /etc/hermes/；三、pip 卸载包并删二进制；四、清理 shell 中 HERMES 相关环境变量；五、WSL2 用户还需清理 apt 依赖及 nvm。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 Hermes Agent，但遇到持续性故障、配置混乱或版本冲突问题，可能需要执行彻底卸载后再重装。以下是多种可并行操作的清除路径，确保残留文件、环境变量、配置及运行时数据被完整移除。
一、停止所有 Hermes Agent 进程并清除运行时状态
该步骤用于终止当前活跃服务，避免文件被占用导致后续删除失败，并清除临时生成的 PID、日志缓存与网关会话锁。
1、在终端中执行 hermes stop 命令，强制关闭主 Agent 与关联网关进程。
2、执行 hermes logs --tail 100 确认无新日志输出，再按 Ctrl+C 退出。
3、手动删除运行时目录：rm -rf ~/.hermes/run/ ~/.hermes/logs/ ~/.hermes/gateway/sessions/。
二、删除核心配置与用户数据目录
此操作将清除模型配置、API Key、自定义 Skill、记忆快照及初始化参数，是实现“干净重装”的关键环节。
1、执行命令删除主配置根目录：rm -rf ~/.hermes/。
2、检查是否存在独立的全局配置文件：ls -la /etc/hermes/；若存在，使用 sudo rm -rf /etc/hermes/ 彻底清除。
3、若曾通过 WSL2 安装，需进入 Ubuntu 子系统后再次运行上述两条删除命令，确保 Windows 侧与 Linux 侧配置完全解耦。
三、卸载 Hermes CLI 工具与 Python 包依赖
该步骤解除命令行工具绑定，清除 pip 安装的包及其元数据，防止旧版本二进制残留干扰新安装流程。
1、执行 pip uninstall hermes-agent -y 卸载主包。
2、运行 which hermes 查看可执行文件路径；若返回非空结果（如 /home/user/.local/bin/hermes），则执行 rm -f $(which hermes) 删除二进制。
3、清理构建缓存：rm -rf ~/.cache/pip/ ~/.hermes/.venv/。
四、清除系统级环境变量与 Shell 初始化项
避免旧版 PATH 注入或 HERMES_HOME 变量残留引发初始化异常，尤其影响后续自动检测与模型加载逻辑。
1、检查 shell 配置文件：grep -n "hermes\|HERMES" ~/.bashrc ~/.zshrc ~/.profile 2>/dev/null。
2、对每处匹配行，手动编辑对应文件，删除包含 export HERMES_HOME=、export PATH=.*hermes 或 source ~/.hermes/init.sh 的整行。
3、执行 source ~/.bashrc（或对应 shell 配置）使变更立即生效，并运行 env | grep HERMES 确认无输出。
五、清理 WSL2 中的 Ubuntu 系统级依赖（仅限 Windows 用户）
当 Hermes Agent 部署于 WSL2 Ubuntu 环境时，需同步清理其底层依赖组件，防止 apt 缓存或 node/python 版本冲突干扰重装。
1、更新并清理 apt 缓存：sudo apt clean && sudo apt autoremove -y。
2、卸载明确由 Hermes 安装引入的包：sudo apt remove -y python3.12-venv python3.12-dev ripgrep nodejs npm（仅限未被其他程序共用的情况）。
3、确认 Node.js 是否通过 nvm 安装：运行 command -v nvm；若返回路径，则执行 nvm deactivate && nvm uninstall 20 并删除 ~/.nvm 目录。
