在 Ubuntu 上安装 Hermes Agent(主流 AI 智能体),虽然官方推荐使用一键安装脚本,全程自动处理依赖,但是我的服务器总是会报错,不知道是因为系统版本还是网络,所以我换了下面这种安装方式。
手动安装(进阶)
sudo apt update
sudo apt install -y git curl build-essential python3.11 python3.11-venv
# 安装 uv 包管理器
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc
# 克隆代码
mkdir -p ~/apps && cd ~/apps
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
#先装依赖(必须)
sudo pip3 install --break-system-packages -r requirements.txt --ignore-installed
#安装剩余的依赖 安装依赖可能会报错 执行下面的语句
sudo pip3 install --break-system-packages anthropic>=0.39.0 exa-py>=2.9.0 "rich<15,>=14.3.3"
✅ 安装完成后验证
# 刷新环境变量
source ~/.bashrc
# 检查 Hermes 是否可用
hermes --version
初始化 & 配置模型
# 启动配置向导(必选)
hermes setup
# 选择模型服务商(Ollama/OpenRouter/OpenAI等)
hermes model
# 检查运行状态
hermes doctor
hermes status
# 启动交互式聊天
hermes
Hermes 已经安装成功了!现在的报错不是安装问题,而是模型上下文窗口不满足要求,我们来快速解决它。
解决方案(两种任选其一)
方案 1:临时覆盖配置(快速生效)
直接启动 Hermes 时强制指定上下文大小:
bash
运行
hermes --model-context 16384
这个命令会临时告诉 Hermes:“我知道我的模型只有 16k 上下文,别拦着我运行”。
方案 2:修改配置文件(永久生效)
- 找到配置文件位置:
cat ~/.hermes/config.yaml - 编辑配置文件:
nano ~/.hermes/config.yaml - 在文件里找到
context_window这一行,改成你的模型大小:model: context_window: 16384 # 改成你的模型实际上下文窗口 - 保存退出(nano 里按
Ctrl+O再按回车,然后Ctrl+X),重新启动 Hermes:hermes
文章末尾固定信息
我的微信
微信号已复制
我的微信
微信扫一扫


