维护咨询 大模型部署 问题解决 技能定制 大模型训练
Hermes Agent支持Linux、macOS和Windows WSL。这三个平台的安装方式几乎一样，本文以Linux为例，其他平台标注差异。
全程约5分钟，不需要编程基础，跟着步骤走就行。
## 系统要求
Linux/macOS：
Python 3.10 或更高版本
pip包管理器
curl（用于下载安装脚本）
Git（用于更新和插件）Windows（WSL）：
Windows 10/11
已安装WSL2
Ubuntu或其他Linux发行版检查Python版本：
python3 --version
# 如果低于3.10，需要先升级Python—
## 安装步骤
第一步：打开终端
Linux：按 Ctrl+Alt+T
macOS：按 Command+Space，搜索”终端”
Windows：WSL里直接输入 wsl 或打开Ubuntu应用
第二步：运行安装脚本
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash脚本会自动：
– 检测Python和pip
– 安装依赖包
– 下载Hermes Agent
– 创建配置文件
– 验证安装
第三步：验证安装
hermes --version看到版本号（如 hermes v2.x.x）说明安装成功。
—
## 配置API Key
安装完成后需要配置AI模型的API Key。
方式一：交互式配置（推荐新手）
hermes setup按提示输入：
– 选择模型提供商（OpenAI/Anthropic/OpenRouter）
– 输入API Key
– 选择默认模型
方式二：手动编辑配置
nano ~/.hermes/.env添加：
OPENAI_API_KEY=sk-your-key-here
# 或者
ANTHROPIC_API_KEY=sk-ant-your-key-here
# 或者
OPENROUTER_API_KEY=sk-or-your-key-here保存退出（Ctrl+O，回车，Ctrl+X）。
—
## 快速测试
启动AI对话：
hermes chat看到欢迎界面后，输入：
你好，你是谁？AI应该会回复。试试再输入：
帮我计算1+1等于几如果AI正常回复，说明安装和配置成功。
—
## Windows WSL特殊说明
安装WSL（如果没有）：
以管理员身份打开PowerShell，运行：
wsl --install重启电脑后，Ubuntu会自动启动，按提示设置用户名和密码。
WSL里的安装：
跟Linux完全一样，用上面的安装命令。
访问Windows文件：
WSL里可以访问Windows文件系统：
cd /mnt/c/Users/你的Windows用户名/Desktop—
## 常见问题
Q：安装脚本报curl错误
A：检查网络连接，或者用代理：
export https_proxy=http://127.0.0.1:你的代理端口
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bashQ：报Python版本不对
A：需要升级Python。Linux/macOS用pyenv，Ubuntu可以用：
sudo apt update
sudo apt install python3.11 python3.11-venv python3.11-devQ：hermes命令找不到
A：重新打开终端，或者手动添加到PATH：
export PATH="$HOME/.local/bin:$PATH"Q：权限报错
A：不要用sudo安装。如果权限有问题：
chmod 755 ~/.hermes
chmod +x ~/.local/bin/hermes—
## 相关文章
暂无评论内容