hermes-browser-extension

在浏览器侧边栏直接调用本地 Hermes 智能体，让网页上下文即刻可用。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 172 🐛 待处理 1 👀 关注 5

GitHub ↗

GitHub 星标 ★ 1823

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源浏览器扩展，本地运行，完全免费。

项目预览

hermes-browser-extension 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队abundantbeing

GitHubhttps://github.com/abundantbeing/hermes-browser-extension

定价模式🏷️完全免费

价格说明开源浏览器扩展，本地运行，完全免费。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型ai-agent,browser-extension,chrome-extension,edge-extension,hermes-agent,local-first,nous-research,sidepanel

GitHub 星标★ 1823

上线时间2026-06-24 00:00:00

代码更新2026-11-09

仓库体积109.9 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

hermes-browser-extension 是一个浏览器原生侧边栏扩展，用于连接 Hermes Agent 与当前网页上下文。它解决了用户在浏览网页时无法便捷调用本地 AI 智能体的问题，将网页内容直接传递给本地运行的 Hermes 运行时，实现上下文感知的智能交互。核心能力包括：侧边栏界面集成、网页上下文捕获与传递、与本地 Hermes Agent 的无缝通信、支持 Chrome 和 Edge 浏览器。该项目采用本地优先（local-first）架构，强调数据隐私和离线可用性，由 Nous Research 团队开发，适合需要深度集成浏览器与本地 AI 工作流的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1823

技术标签

ai-agent browser-extension chrome-extension edge-extension hermes-agent

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 15 分钟部署方式：浏览器扩展 6 步

环境要求

Node.js 与 npm（README 使用 npm install / npm run build）
已安装 Chrome / Edge / Chromium 浏览器（或 Firefox）
已运行的 Hermes Agent 运行时或本地网关（Local gateway）
可访问的网关地址与 API key（Local / Remote 连接需要）

安装与启动步骤

1克隆扩展源码

从 GitHub 拉取仓库，得到完整源码目录，后续所有构建命令都在该目录内执行。
```
git clone https://github.com/abundantbeing/hermes-browser-extension.git
```
2安装依赖

进入仓库目录后安装 npm 依赖，README 明确要求执行 npm install。
```
cd hermes-browser-extension
npm install
```
3构建扩展

执行构建生成可加载的产物目录 dist，加载扩展时选择该目录。
```
npm run build
```
4加载未打包扩展

在 Chrome/Edge 打开 chrome://extensions，开启开发者模式，用“加载已解压的扩展程序”选择 dist 文件夹。
5选择连接方式

侧边栏连接失败时用 Manual setup，选 Local gateway、Hermes Cloud 或 Remote gateway；Local/Remote 填 Gateway URL 与 API key。
6Firefox 用户安装

Firefox 直接在 AMO 点击 Add to Firefox，用 Ctrl+Shift+H 打开侧边栏，更新由 AMO 自动推送。

关键配置

配置项	必填	说明	示例
`Gateway URL`	是	本地网关或自托管远程网关的访问地址，Local/Remote API 连接必填	`http://localhost:<你的网关端口>`
`API key`	是	连接 Local/Remote 网关所需的密钥，勿泄露或提交	`sk-xxxxxxxx`

如何确认成功

侧边栏显示已连接（网关 /health 可访问即视为可达），注意此时可能出现 runtime warning 但仍保持连接。

常见问题

Q：侧边栏提示 runtime warning 但仍显示已连接？

A：v0.3.0 起将网关可达性与上游 Hermes 运行时/工具失败分开判断。请查看运行网关那台机器上的 Hermes Agent 日志；若堆栈涉及 computer_use 或 cua-driver，运行 hermes computer-use doctor。

Q：首次运行的 Connect 流程不可用怎么办？

A：改用 Manual setup，选择 Local gateway、Hermes Cloud 或 Remote gateway。Local/Remote 需要 Gateway URL 和 API key；Cloud 与 dashboard-ticket 需要已登录的 HTTPS dashboard 标签页。

Q：Firefox 可以侧载 GitHub 的 zip 吗？

A：不可以。GitHub 上的 zip/tar.gz 是源码归档而非 Firefox 附加组件，Firefox 版请从 AMO 安装并以 Mozilla 签名更新。

Q：不同连接方式能力有区别吗？

A：有。Local 与 Remote API 连接可使用 Hermes 已配置的模型、工具、技能、会话、记忆和 MCP 服务器；Cloud 与 dashboard-ticket 连接仅支持 Chat。