应使用 Python 3.11 安装 Hermes Agent：先通过 uv 安装并激活 3.11 虚拟环境，再用 python3.11 显式运行安装脚本；若失败，可克隆源码、激活环境后强制安装依赖，并将 pyproject.toml 中 requires-python 改为 "^3.11"。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试安装 Hermes Agent，但安装过程在依赖解析或编译阶段中断，并出现 Python 版本相关报错，则很可能是当前系统 Python 版本与 Hermes Agent 要求不匹配。以下是解决此问题的步骤：
一、验证并切换至兼容的 Python 版本（3.11）
Hermes Agent 明确要求使用 Python 3.11，部分 C 扩展（如 tiktoken、pyo3 绑定）在 3.12 或 3.13 上存在构建失败或运行时崩溃风险。安装脚本虽尝试自动创建 3.11 虚拟环境，但若系统默认 Python 过高，会干扰 uv 的环境判定逻辑。
1、检查当前默认 Python 版本：
python3 --version
2、若输出为 3.12.x 或 3.13.x，需显式指定 3.11：
uv python install 3.11
立即学习“Python免费学习笔记（深入）”；
3、创建独立虚拟环境并激活：
uv venv --python 3.11 ~/.hermes/venv
source ~/.hermes/venv/bin/activate
4、确认当前解释器路径指向 3.11：
which python3
python3 --version
二、强制使用 3.11 执行安装脚本
绕过脚本对系统 Python 的自动探测逻辑，直接以 3.11 解释器运行安装流程，可避免因全局版本过高引发的 uv 或 pip 行为异常。
1、下载安装脚本到本地：
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh -o install.sh
2、赋予执行权限：
chmod +x install.sh
3、使用 Python 3.11 显式调用：
python3.11 install.sh
4、安装完成后，确保可执行文件路径已纳入 shell 环境：
务必执行 source ~/.bashrc 或 source ~/.zshrc 刷新 PATH
三、手动安装依赖并跳过版本校验
当自动安装流程因版本检测失败而中止时，可进入源码目录，跳过预检步骤，直接安装已知兼容的依赖组合。
1、克隆仓库（使用国内镜像加速）：
git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git ~/.hermes/hermes-agent
2、进入项目目录：
cd ~/.hermes/hermes-agent
3、激活 3.11 虚拟环境：
source ~/.hermes/venv/bin/activate
4、安装依赖并忽略 Python 版本警告：
pip install -r requirements.txt --force-reinstall --no-deps
pip install -e . --no-deps
5、关键操作：手动覆盖 pyproject.toml 中的 requires-python 字段为 "^3.11"
