必须创建Python 3.11+虚拟环境，推荐用uv创建并指定--python 3.11；激活后升级pip、配置清华镜像源，再执行pip install -e ".[all]"安装Hermes Agent。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在Linux上稳定运行Hermes Agent，必须先创建隔离、可控的Python虚拟环境——直接用系统Python安装会导致依赖冲突、权限混乱甚至破坏系统工具。
检查并准备Python 3.11+
执行 python3 --version，确认输出为 3.11.0 或更高版本。若低于此版本或命令报错，请先升级：Ubuntu/Debian用户运行 sudo apt update && sudo apt install python3.11 python3.11-venv python3.11-dev；CentOS/Fedora用户使用 sudo dnf install python311（Fedora）或启用EPEL后安装。
注意：不要用 apt install python3 默认安装的旧版Python，Hermes Agent v0.13.0 明确要求 Python ≥3.11 —— 用错版本会导致后续 pip 安装失败且报错信息模糊。
选择虚拟环境管理器
方法一：用系统自带的 venv（最轻量，适合快速验证）
执行 python3.11 -m venv ~/.hermes/venv 创建虚拟环境到标准路径。
这一步不依赖额外工具，但后续安装依赖速度较慢，且无法自动处理可选功能模块（如浏览器自动化）。
方法二：用 uv（推荐，速度快、兼容强）
先安装 uv：curl -LsSf https://astral.sh/uv/install.sh | sh；
再创建带 Python 3.11 的环境：uv venv ~/.hermes/venv --python 3.11。
【务必指定 --python 3.11】，否则 uv 可能默认选用系统中其他版本，导致运行时 ImportError。
激活并升级基础工具
第一步：激活环境source ~/.hermes/venv/bin/activate
第二步：升级 pip 和 setuptoolspip install --upgrade pip setuptools
这一步不能跳过——旧版 pip 在解析 Hermes Agent 的 pyproject.toml 时会忽略 [all] extras 标记，导致工具链（如 Playwright、GitPython）缺失。
第三步：配置国内镜像源（国内用户必做）pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
否则从 PyPI 下载依赖可能超时中断，尤其在安装 playwright 或 torch 相关组件时。
安装 Hermes Agent 主体
进入项目目录（若已克隆）：cd ~/hermes-agent；
执行安装命令：pip install -e ".[all]"。
若尚未下载代码，先运行：git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git ~/hermes-agent。
如果 git clone 卡住或报 unexpected eof，说明 GitHub 访问不稳定——立即中断，改用离线包：
① 下载百度网盘中的 hermes-agent-main.zip（提取码：9dbu）；
② 解压到 ~/hermes-agent：unzip ~/hermes-agent-main.zip -d ~ && mv ~/hermes-agent-main ~/hermes-agent；
③ 再执行 pip install -e ".[all]"。
安装完成后，终端提示符前应出现 (venv)，且执行 hermes --version 能返回类似 hermes, version 0.13.0 的输出。
