Hermes Agent v0.19.0 安装中断须强制清理残留进程并手动重建 Python 3.11 虚拟环境:先执行 pkill -f "uv\|python3.11\|install.sh",再用 uv python install 3.11 和 uv venv --python 3.11 ~/.hermes/venv 创建干净环境,最后激活并以 python3.11 install.sh 或 pip install "hermes-agent==0.19.0" 安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

安装 Hermes Agent v0.19.0 时脚本在依赖解析、uv 环境创建或 pip 安装环节突然中断,终端卡住无响应、报错后自动退出,或提示“Killed”“Segmentation fault”“No module named ‘pydantic’”,说明 Python 运行时上下文已损坏或版本校验被绕过——这不是网络抖动或权限不足的表层问题,而是 v0.19.0 对 Python 3.11 的硬性绑定与系统环境发生冲突所致。
确认中断点并终止残留进程
执行 pkill -f "uv|python3.11|install.sh" 强制杀掉所有可能卡死的子进程;若提示 “No process found”,说明脚本已彻底退出,跳过此步。
检查 ~/.hermes/venv/ 是否存在但不完整:若目录存在但 bin/activate 文件缺失或 lib/python3.11/site-packages 为空,则证明 uv 创建虚拟环境失败,必须清理后重来。
【不要直接 rerun install.sh】 脚本自带幂等逻辑,但 v0.19.0 的 uv 初始化阶段若中途崩溃,会残留损坏的 .venv.lock 或部分编译中间文件,再次运行将复现相同错误。
手动重建 3.11 虚拟环境
第一步:确保 uv 已安装且支持 3.11
运行 uv --version,输出应包含 “0.4+”;若未安装,先执行 curl -LsSf https://astral.sh/uv/install.sh | sh。
第二步:显式安装 Python 3.11uv python install 3.11 ——这一步不可跳过,即使系统已有 3.11,uv 仍需将其注册到自身管理列表中,否则后续 uv venv 会 fallback 到系统默认版本。
第三步:创建干净虚拟环境uv venv --python 3.11 ~/.hermes/venv ——路径必须与官方脚本一致,否则后续 hermes 命令找不到解释器。
第四步:激活并验证source ~/.hermes/venv/bin/activate && python3 --version,输出必须为 Python 3.11.x,且 which python3 指向 ~/.hermes/venv/bin/python3。
绕过脚本,用 python3.11 直接安装
方法一:下载并本地执行安装脚本curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh -o install.sh → chmod +x install.sh → python3.11 install.sh
方法二:跳过脚本,直接 pip 安装(适用于已激活 3.11 环境)pip install "hermes-agent==0.19.0" ——注意加引号,避免 shell 将 == 解析为赋值操作。
【关键前提】 执行前必须确认当前 shell 中 python3 和 pip 均指向 ~/.hermes/venv/ 下的 3.11 实例,否则 pip 会把包装进系统 site-packages,hermes 启动时仍加载失败。
修复 pyproject.toml 兼容性(仅当 pip install 报 requires-python 错误时)
进入 ~/.hermes/venv/src/hermes-agent/(若不存在则先 git clone https://github.com/NousResearch/hermes-agent.git ~/.hermes/venv/src/hermes-agent)
编辑 pyproject.toml,定位 requires-python = "^3.11" 行,将 ^3.11 改为 ==3.11.* ——v0.19.0 的 pyo3 绑定在 3.11.9 上经过充分测试,放宽范围可能导致 tiktoken 编译失败。
保存后,在激活环境中运行:pip install -e . --no-deps → pip install -r requirements.txt ——先跳过依赖安装,再单独处理,可避开 uv 的递归解析死锁。











