Hermes Agent 缺失依赖时需分层手动安装：先运行 hermes doctor 和 hermes envcheck 定位问题，再按系统（Ubuntu/macOS）装 ripgrep、ffmpeg 等系统级工具，接着激活 ~/.hermes/venv 虚拟环境安装 Python 模块，最后在 ~/.hermes/gateway 目录下用 Node.js 安装网关所需 NPM 包。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试运行 Hermes Agent 时提示缺少特定依赖包（如 ripgrep、ffmpeg、Python 模块等），则说明安装脚本未能自动完成全部依赖部署，或系统环境存在隔离干扰。以下是手动安装缺失依赖包的具体方法：
一、确认缺失的依赖项
执行诊断命令可精准识别缺失组件。Hermes Agent 提供内置检查工具，用于定位未就绪的依赖。
1、在终端中运行诊断命令：hermes doctor
2、观察输出中被标记为 MISSING 或 NOT FOUND 的条目，例如 rg、ffmpeg、python3.12-venv 等。
3、同时可运行环境检测命令进一步验证：hermes envcheck
二、手动安装系统级依赖（Linux / WSL2）
针对 Ubuntu/Debian 系统，需使用 apt 安装底层工具链。这些组件不通过 pip 或 npm 安装，而是由系统包管理器提供。
1、更新软件源列表：sudo apt update
2、安装 ripgrep（高速文本搜索工具）：sudo apt install -y ripgrep
3、安装 ffmpeg（音视频处理支持）：sudo apt install -y ffmpeg
4、安装 Python 3.12 及虚拟环境支持（若 Python 版本过低）：sudo apt install -y python3.12 python3.12-venv python3.12-dev
5、安装 QR 码与图像处理模块（用于微信接入等场景）：sudo apt install -y python3-qrcode python3-pil
三、手动安装系统级依赖（macOS）
macOS 用户需依赖 Homebrew 包管理器完成基础工具安装。请确保已安装 brew，否则先执行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
1、更新 Homebrew：brew update
2、安装 ripgrep：brew install ripgrep
3、安装 ffmpeg：brew install ffmpeg
4、安装 Python 3.12：brew install python@3.12
5、安装图像处理依赖：brew install libjpeg libpng libtiff
四、手动安装 Python 虚拟环境内依赖
Hermes Agent 使用独立 Python 虚拟环境（venv），外部 pip 安装无效。必须进入其 venv 后安装模块。
1、定位 Hermes 虚拟环境路径（通常为 ~/.hermes/venv）：ls ~/.hermes/venv/bin/activate
2、激活该虚拟环境：source ~/.hermes/venv/bin/activate
3、在激活状态下安装缺失模块（例如 aiohttp、lark-oapi）：pip install aiohttp lark-oapi
4、退出虚拟环境：deactivate
五、手动安装 Node.js 依赖（如需扩展网关功能）
部分网关插件（如飞书、微信）依赖 Node.js 运行时及对应 NPM 包，需在 Hermes 的 Node 模块目录下操作。
1、进入 Hermes 的 gateway 目录：cd ~/.hermes/gateway
2、确认 Node.js 版本符合要求（v22+）：node --version
3、若版本不符，使用 nvm 切换：nvm install 22 && nvm use 22
4、安装缺失的 NPM 包（例如 @larksuiteoapi/node-sdk）：npm install @larksuiteoapi/node-sdk
