Hermes-Agent 安装教程 (Debian/Ubuntu)

直接用这个：

Linux/macos都可用
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

换源后安装curl即可，最好有安装node.js(如果没有安装，下文有)

1. 准备工作 (系统级依赖)

1. apt换源

   打开镜像站，找到自己的系统，里面有操作指示，不多赘述
   https://mirror.tuna.tsinghua.edu.cn/help/AOSP/ 
   不知道系统版本使用：
   hostnamectl 命令查看
   
   

2. 确保系统已安装必要的工具：

   sudo apt update
   sudo apt install python3-pip git curl -y
   换了源 update 还失败看最后面
   

3. 安装 uv (使用国内镜像源方式)：

   curl -sL https://mirrors.ustc.edu.cn/github-release/astral-sh/uv/LatestRelease/uv-installer.sh | sh
   

2. 获取 Hermes-Agent 源代码

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

3. 创建并激活 Python 虚拟环境

# 使用 uv 创建虚拟环境，并指定清华 PyPI 镜像源
uv venv venv --python 3.11 --default-index https://pypi.tuna.tsinghua.edu.cn/simple

# 激活虚拟环境
source venv/bin/activate

4. 安装 Hermes-Agent 及其依赖

# 使用 uv 安装项目及其开发依赖，指定清华 PyPI 镜像源
uv pip install -e "./[all,dev]" -i https://pypi.tuna.tsinghua.edu.cn/simple

5. 将 hermes 命令添加到环境变量

# 确保当前在 hermes-agent 项目根目录下
# 创建指向 hermes 可执行文件的符号链接到用户本地 bin 目录
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes

6. (可选) 安装 Node.js 环境 (使用 nvm)

# 安装 nvm (国内镜像源)
/bin/bash -c "$(curl -fsSL https://gitee.com/iamzhihuix/nvm-install-cn/raw/main/install.sh)"

win10_WSL2的一个问题

WSL2无法切换到镜像网络（因为win10不支持镜像网络），没法正常DNS解析，导致apt update失败

# 临时更改
echo "nameserver 114.114.114.114" | sudo tee /etc/resolv.conf
这个DNS ip 填家里路由器 ip 也行
# 永久更改
wsl系统里面的 vi 不好用，建议照上面临时改一下再安装 vim

sudo vim /etc/wsl.conf
添加以下内容：

[network]
generateResolvConf = false

# 按ESC,然后Shift + Z + Z。保存
 

如果按照上面临时改了DNS，可进行如下备份操作

sudo cp /etc/resolv.conf /etc/resolv.conf.bak

在CMD 或 PowerShell 中 执行：

wsl --shutdown

重新启动wsl系统并执行

sudo cp /etc/resolv.conf.bak /etc/resolv.conf

或

sudo bash -c 'echo "nameserver 114.114.114.114" > /etc/resolv.conf'

sudo apt update
# 没问题就正常了