让 AI 安全跑 shell 命令:Hermes Agent 的 7 种终端后端 20 分钟上手
【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent
你想让 AI 帮你执行pip install、跑脚本,又怕它直接在你的机器上乱写。Hermes Agent 解决的就是这个问题:它把终端命令放进隔离容器执行,提供 Docker、SSH、Singularity、Modal 等 7 种终端后端。适合两类人:需要让 Agent 真正动手干活、但没法完全放心让它碰本地环境的开发者;以及想在手机上远程指挥 Agent 的用户。
先跑起来:Hermes Agent 最短路径安装
读完这一节,你能在本机启动 Hermes Agent 的第一轮对话。
git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent hermes setup # 设置向导:一次性配置模型、工具、消息网关 hermes # 启动终端 TUI,开始对话第一条命令拉取源码,hermes setup会引导你完成全部初始配置,hermes直接进入带补全和历史记录的终端界面。装好后用hermes model可以切换模型提供方(OpenRouter、OpenAI 或自建端点),不需要改任何代码。✅
Hermes Agent 最实用的 3 个场景:容器隔离、手机调用、定时任务
读完这一节,你能判断哪些工作值得交给 Hermes Agent。
Docker 隔离执行:让 Agent 装包不脏本机当你不确定 Agent 要跑什么命令时,把终端后端切到 Docker,所有命令都在容器里执行,默认镜像是python:3.11-slim。装错依赖最多只影响~/.hermes/sandboxes/下的沙箱目录,本机环境原样保留。
从 Telegram、Discord 调用:把 Agent 变成手机上的机器人当人不在电脑前却想看任务进度时,运行hermes gateway setup启动网关,之后给机器人发消息即可,会话与本地保持同步。出门在外查个报错、催一句执行,不用再回工位。
无人值守的定时任务需要每天一份日报或每晚一次备份时,用自然语言描述任务,内置的 cron 调度器到点执行并把结果投递到你指定的平台。省掉的是自建定时服务器和部署脚本这一步。
关键配置逐项拆解:Hermes Agent 的 Docker 配置方法
读完这一节,你能把 Docker 隔离环境按项目需要调整。常用配置项如下:
| 配置项 | 默认值 | 改了会发生什么 | 什么时候需要改 |
|---|---|---|---|
| 终端后端 | local | 换成 docker 后命令改在容器里执行 | 只要 Agent 要跑不可信命令就开 |
| docker_image | python:3.11-slim | 沙箱的基础镜像随之更换 | 项目是 Node 前端或 Go 服务时 |
| docker_shm_size | 1g | 容器共享内存上限变化 | 跑训练或大内存任务时 |
| docker_mount_cwd_to_workspace | false | 改为 true 会把本地工作目录挂进容器 | Agent 需要读你仓库里的文件时 |
| docker_persist_across_processes | true | 改为 false 沙箱状态不再跨会话保留 | 需要一次性、用完即弃的临时环境时 |
改配置不必翻源码,用两条命令就够了:
hermes config set # 修改单个配置项,比如镜像和共享内存 hermes doctor # 诊断终端后端与配置是否有问题hermes doctor能直接指出后端不通或配置冲突在哪,排障时先跑它。🔧
容易踩的坑:Hermes Agent 常见报错排查
读完这一节,你能处理安装和使用中最常遇到的三个问题。
⚠️ 现象:上次装的包不见了。原因:沙箱没启用持久化,会话结束环境就重建了。怎么办:保持docker_persist_across_processes为 true,已安装的包和文件会保留在~/.hermes/sandboxes/里,下个会话直接接着用。
现象:装完敲hermes提示命令不存在。原因:安装脚本改了 shell 配置,但当前终端还没重新加载。怎么办:执行source ~/.bashrc(zsh 用户换成~/.zshrc)再试。
现象:Windows 杀毒软件把uv.exe隔离了。原因:这是针对未签名 Rust 二进制的误报,该文件是 Hermes 自带的 Python 包管理器 uv。怎么办:在杀毒软件里把%LOCALAPPDATA%\hermes\bin整个文件夹加入白名单,注意加文件夹而不是文件哈希,因为每次版本更新哈希都会变。
Hermes Agent 的核心是把 Agent 放进你可控的环境里跑,并让它从经验里积累技能,而不是每次从零开始。完整配置项和文档入口见仓库内的 README.md 与 SECURITY.md,从这两个文件可以直达官方文档目录。
【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考