hermes-browser-extension

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

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

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1552

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队abundantbeing

所属国家

官网地址

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

定价模式free

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

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

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

GitHub 星标★ 1552

30天Star增速

HF 下载量

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

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：进阶约 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。

注意事项

Chrome Web Store 尚未上架，Chrome/Edge/Chromium 需以 load unpacked 方式加载 dist 目录。
请勿泄露、打印、截图或提交任何 API key 与 WebSocket ticket。
Firefox 不要侧载 GitHub 源码压缩包，只能通过 AMO 安装。
架构为本地优先（local-first），数据经本地网关传递，注意保护本机运行时日志。

核心亮点

原生侧边栏集成，不打断浏览流程，操作直观
本地优先架构，网页数据不出设备，隐私保护强
无缝对接 Hermes Agent，支持复杂上下文推理

不足之处

依赖 Hermes Agent 环境，非独立可用
文档/社区待观察

适用场景

网页阅读时快速摘要或问答
网页内容翻译或改写
结合本地知识库进行深度分析

替代项目

Chrome AI Extension、Sidekick Browser Extension、Khoj Browser Extension

项目介绍

hermes-browser-extension 是智能体领域的开源项目，由 abundantbeing 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,552）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,199 增加到 1,552，净增 353。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。开源浏览器扩展，本地运行，完全免费。

它主要面向的使用场景是：网页阅读时快速摘要或问答。同类可对比的替代方案包括 Chrome AI Extension、Sidekick Browser Extension、Khoj Browser Extension。

上一篇：thClaws

下一篇：intelligent-audit-system