hermes agent原生仅支持python,其他语言需通过http网关(js/ts)、cli(shell)、或自定义端点(java/go/rust)间接集成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在开发集成 Hermes Agent 的应用时需要确认其 SDK 所支持的编程语言,则需注意 Hermes Agent 本身是用 Python 构建的运行时系统,其核心 SDK 和官方工具链仅原生提供 Python 接口。以下是支持该 Agent 集成的编程语言相关说明:
一、Python(原生支持)
Hermes Agent 的核心实现与 SDK 完全基于 Python,占比达 93.6%,所有功能模块(包括模型路由、工具编排、记忆管理、网关调度)均通过 Python API 暴露。安装后可直接导入 hermes 模块进行定制化调用。
1、确保已安装 Hermes Agent v0.8.0 或更高版本,执行 hermes --version 验证。
2、在 Python 脚本中使用 from hermes.agent import AIAgent 导入主类。
3、调用 AIAgent().run(prompt, tools=["shell", "http"]) 启动带工具链的会话。
二、JavaScript/TypeScript(通过 HTTP 网关)
Hermes Agent 提供内置的 RESTful 网关服务(默认监听 localhost:8000),允许非 Python 环境通过标准 HTTP 请求与其交互,无需 SDK 绑定。该方式不依赖语言特有库,仅需兼容 HTTP/JSON 协议。
1、启动网关服务:执行 hermes gateway start --port 8000。
2、发送 POST 请求至 http://localhost:8000/v1/chat/completions,携带符合 OpenAI 兼容格式的 JSON payload。
3、响应体结构与 OpenAI API 完全一致,可直接复用现有 JS/TS 的 fetch 或 axios 封装逻辑。
三、Shell/Bash(通过 CLI 子命令)
Hermes Agent 提供完整的命令行接口,所有核心能力均可通过 shell 命令触发。适用于自动化脚本、CI/CD 流水线或轻量级胶水逻辑集成,无需任何语言运行时依赖。
1、执行 hermes run --prompt "列出当前目录下所有 Python 文件" 直接调用 Agent 执行任务。
2、结合管道与重定向:如 echo "生成 Fibonacci 前10项" | hermes run --format json。
3、启用工具时添加 --tools shell,http 参数以激活对应插件。
四、其他语言(通过 WebSocket 或自定义端点)
对于 Java、Go、Rust 等语言,Hermes Agent 不提供官方 SDK,但可通过其开放的自定义端点机制接入。用户可在配置中指定外部服务地址,Agent 将把工具调用请求转发至该地址,由目标语言服务完成处理并返回结果。
1、编辑 ~/.hermes/config.yaml,在 toolsets 下添加自定义工具定义。
2、设置 endpoint: http://localhost:9000/tool/shell-exec 指向本地 Java/Go 编写的 HTTP 处理器。
3、确保该端点接收 application/json 请求,并返回符合 Hermes 工具响应规范的 JSON 对象(含 status、output 字段)。











