abundantbeing/hermes-browser-extension

Hermes Browser Extension – Quick Overview

무엇인가요 – Chromium 기반의 사이드패널 확장 기능으로, 브라우저에서 실제 Hermes Agent (Nous Research에서 개발한 오픈소스 AI 에이전트 런타임)에 직접 연결할 수 있습니다. 이것은 독립형 챗봇이 아닙니다. 현재 웹 컨텍스트(활성 탭, 선택된 텍스트 등)를 Hermes 게이트웨이(로컬, 클라우드 호스팅, 또는 자체 호스팅)로 전달하고, 에이전트의 응답을 표시하는 것입니다.

주요 기능

• 다중 에이전트 '봇 모드' – 원하는 Hermes 프로필/에이전트를 즉시 전환 가능하며, 각 에이전트의 대화 기록을 유지하고 그룹 채팅 스레드를 실행할 수 있습니다.
• 스마트 탭 스코핑 – 기본적으로 활성 탭만 모델에 전송됩니다. 다른 탭을 IN/OUT로 전환하거나, AI 기반의 /sort-tabs 클러스터링을 실행하거나, 모든 탭을 포함할 수 있습니다.
• Hermes Assist – 31개의 일반적인 작성 환경(이메일, 소셜 게시물, 이슈 트래커 등)을 감지하는 사이트 인식 드래프트 패널로, 에이전트가 드래프트를 생성하지만 명시적으로 삽입해야 합니다.
• 페이지 주석 – 페이지의 어떤 요소든 선택해 메모를 추가하고, 프롬프트를 오염시키지 않고 챗 컴포저 옆에 핀으로 큐잉할 수 있습니다.
• 풀세션 워크스페이스 (Hermes Web Alpha) – 세션 레일, 마크다운 렌더링, 미디어 미리보기, 도구 활동 스트립, 세션별 모델 바인딩을 갖춘 더 풍부한 뷰입니다.
• 라이브 제어 (MV3 컨트롤러) – 사용자 명시적 승인 후, 에이전트가 임대된 탭에서 특권 작업(클릭, 입력, 스크롤)을 수행할 수 있는 선택적 기능입니다.
• 진단 및 투명성 – "Hermes가 본 것"의 수령 확인, 진단 복사 버튼, 메타데이터 엔드포인트(/meta, /metadata, /head)를 통해 전송된 컨텍스트를 정확히 확인할 수 있습니다.
• 테마 – 9가지 내장 테마(Light/Dark/System + Nous, Midnight, Ember, Mono, Cyberpunk, Slate, Senter Space, Aphrodite, Solstice).

지원 브라우저

• Chrome / Edge / Brave / 기타 Chromium 브라우저 (사이드 패널 API, Chrome 116+).
• Firefox (AMO 경유) – 채팅과 컨텍스트는 작동하지만, Firefox는 필요한 debugger API를 지원하지 않아 고급 탭 제어 기능은 사용 불가.
• Safari – 현재 제공되지 않음.

시작 방법

1. 사전 요구 사항 – 실행 중인 Hermes Agent(로컬 게이트웨이, Hermes Cloud, 또는 원격 API)와 Node 20+.
2. 빌드

   git clone https://github.com/abundantbeing/hermes-browser-extension.git
   cd hermes-browser-extension
   npm install
   npm run build   # dist/에 출력
   

3. 로드
   • Chromium: chrome://extensions 열기, 개발자 모드 활성화, "Load unpacked" → dist/ 선택.
   • Firefox: AMO 페이지에서 설치 (수동 사이드로딩 필요 없음).
4. 확장 기능 아이콘 또는 Alt+H (기본 단축키)로 사이드패널 열기.
5. 설정 패널에서 Local gateway, Hermes Cloud, 또는 Remote gateway 선택하고, 필요 시 URL/API 키 입력.

일반적인 워크플로우

1. 에이전트가 보게 하고 싶은 웹 페이지 열기.
2. 사이드패널 클릭, 필요 시 다른 탭 전환 또는 /sort-tabs 사용.
3. 명령어(/summarize, /explain, /rewrite 등) 입력 또는 자유형 질문 입력.
4. 스트리밍된 응답 확인, "Hermes가 본 것" 수령 확인 검토, Hermes Assist 사용 시 드래프트를 페이지의 컴포저에 삽입.

왜 중요한가요

• 모델, 도구, 메모리, 기술을 포함한 전체 Hermes 런타임을 루프에 유지하며, 단순화된 챗봇이 아님.
• 세밀한 프라이버시 제어: 명시적으로 스코프된 탭만 전송되며, URL은 마스킹되며, 모든 컨텍스트는 전송 전 사용자에게 노출됨.
• 로컬 AI 에이전트와 일상적인 웹 워크플로우 사이의 격차를 메우며, 브라우저를 벗어나지 않고도 강력하고 컨텍스트 인식 지원을 가능하게 함.

---

자료

• 프로젝트 리포지토리: https://github.com/abundantbeing/hermes-browser-extension
• Hermes Agent 문서: https://hermes-agent.nousresearch.com/docs
• Firefox 애드온: https://addons.mozilla.org/en-US/firefox/addon/hermes-browser-extension/

위 모든 세부 정보는 리포지토리의 README에서 직접 인용되었습니다.