Hermes Agent环境搭建需分四步：一键安装（推荐）、手动安装（适配网络受限场景）、初始化配置（运行hermes setup）、模型提供商配置（如百炼API）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在本地或服务器上部署 Hermes Agent，但无法完成基础环境搭建，则可能是由于依赖缺失、网络限制或配置路径错误。以下是完成 Hermes Agent 环境搭建的具体步骤：
一、一键安装（推荐新手）
该方式自动检测并安装 Python、Node.js、Git、ripgrep 等全部必要依赖，适用于 macOS、Linux 和 Windows（PowerShell 管理员模式），避免手动排查环境冲突。
1、打开终端（macOS/Linux）或以管理员身份运行 PowerShell（Windows）。
2、执行官方安装命令：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash（Linux/macOS）。
3、Windows 用户请执行：irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex。
4、等待脚本自动完成下载、解压、依赖安装与 CLI 注册，出现欢迎界面即表示安装成功。
二、手动安装（适合受网络限制场景）
当一键脚本因 GitHub 访问不稳定而卡在克隆仓库阶段时（常见于国内云服务器），可采用分步手动安装，绕过实时 Git 拉取环节。
1、先确保系统已安装 git、Python 3.11+、uv 包管理器；若未安装，执行：sudo apt update && sudo apt install -y git python3.11 python3.11-venv（Ubuntu）。
2、在本地电脑浏览器访问 https://github.com/NousResearch/hermes-agent，点击绿色 Code 按钮 → Download ZIP。
3、将下载的 hermes-agent-main.zip 上传至服务器目标目录（如 /home/ubuntu/）。
4、在服务器终端解压并设置权限：unzip hermes-agent-main.zip && mv hermes-agent-main ~/.hermes/hermes-agent。
5、进入目录并激活 uv 虚拟环境：cd ~/.hermes/hermes-agent && uv venv && source .venv/bin/activate。
6、安装核心后端：uv pip install -e "./mini-swe-agent"。
三、初始化配置
安装完成后必须运行初始化向导，否则 CLI 命令不可用且模型无法加载。该步骤会生成默认配置文件并校验基础路径。
1、执行初始化命令：hermes setup。
2、选择 Quick setup（推荐新手），其余选项按提示输入 Y 确认。
3、向导将自动创建 ~/.hermes/config.yaml 并写入基础结构。
4、验证 CLI 是否就绪：hermes --version，输出版本号即表示配置生效。
四、模型提供商配置
Hermes 本身不内置模型，必须显式指定 LLM 提供商及凭证，否则后续所有交互将返回空响应或报错。
1、执行模型配置命令：hermes model。
2、在交互菜单中选择 Custom endpoint (OpenAI compatible)。
3、输入百炼 Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1（必须准确，否则触发空响应）。
4、粘贴从阿里云百炼控制台获取的 API Key（格式为 sk-xxxxxxxxxxxxxxxxxxxxxxxx）。
5、选择默认模型：qwen-turbo（轻量、低延迟，支持中文语义理解）。
五、系统级依赖预装（规避 pip 报错）
部分 Linux 发行版在后续接入微信等平台时，会因缺少系统级图像/二维码库导致 pip 安装失败（如 externally-managed-environment 错误）。需提前通过 apt 安装对应包。
1、更新系统包索引：sudo apt update。
2、安装关键依赖：sudo apt install -y python3-qrcode python3-pil。
3、该操作跳过 pip 安装路径，直接由系统包管理器提供二进制支持，彻底规避虚拟环境冲突。
