LLM Wiki

Hermes HUD Web UI: 영속 메모리 Hermes 에이전트를 위한 브라우저 대시보드

Properties2
descriptionHermes의 로컬 데이터와 CLI를 읽어 상태·메모리·세션·비용·도구 라우팅을 보여주고 실행 기록을 Replay 산출물로 내보내는 웹 UI.
tagsai-agents, dev-tools, open-source, python, typescript

5 min read

개요

Hermes HUD Web UI는 영속 메모리를 사용하는 Hermes 에이전트의 로컬 상태를 브라우저에서 확인하는 모니터링 대시보드다. ~/.hermes/ 데이터 디렉토리와 hermes CLI를 직접 읽으며, 작성자는 Hermes Agent v0.17.0 및 state.db 스키마 v16을 기준으로 검증했다고 설명한다. 대시보드는 19개 탭으로 상태·메모리·스킬·세션·비용·모델·게이트웨이·플러그인 등을 보여주고, Hermes Replay로 실행 기록을 정적 산출물로 내보낼 수 있다. 글은 설치 방법, Safe Share Mode, 지원 플랫폼과 MIT 라이선스도 함께 소개한다.

핵심 포인트

  • 실행 요약 대시보드는 health, 지출 추이, 자주 사용하는 모델, 제공자·게이트웨이 리스크, 비용이 큰 세션과 조치가 필요한 항목을 보여준다. 파일시스템과 WebSocket 업데이트에 반응해 상태를 갱신한다.
  • Memory, Skills, Sessions, Replay, Cron, Projects, Health, Costs, Models, Patterns, Corrections, Sudo Governance, Live Chat, OAuth, Gateway, Plugin Hub, Live Model Features 등을 포함해 Hermes 운영 정보를 19개 탭으로 나눈다.
  • Gateway 탭은 웹 검색·이미지 생성·TTS·브라우저 자동화 같은 도구가 Nous Tool Gateway를 통하는지, 직접 키를 쓰는지, 사용할 수 없는지를 표시한다. Plugin Hub에서는 플러그인의 런타임 상태와 인증 명령을 확인하고 활성화·비활성화·업데이트를 수행할 수 있다.
  • Hermes Replay는 세션의 정규화된 타임라인과 실행 영수증을 검토한 뒤, 편집된 JSON·GitHub Markdown·독립 HTML·1200×630 PNG 카드·fork-safe fork.json으로 내보낸다. 기본 저장 위치는 로컬 ~/.hermes-hud/replays/다.
  • Safe Share Mode는 원시 도구 인자, 터미널 출력, 어시스턴트 추론 과정, 토큰 형태의 값, 이메일과 로컬 경로 같은 민감한 필드를 내보내기 전에 가린다. 로컬 해시와 Ed25519 서명은 산출물 무결성을 위한 것이며, 외부 제3자의 검증을 의미하지 않는다.
  • 실행에는 Python 3.11 이상, Node.js 18 이상, Hermes 데이터가 필요하다. 저장소를 클론한 뒤 ./install.sh와 hermes-hudui를 실행하고 http://localhost:3001에서 접속하며, macOS·Linux·WSL을 지원한다.

왜 중요한가

영속 메모리와 도구 호출을 사용하는 에이전트는 모델 사용량, 데이터 라우팅, 저장된 메모리, 세션 실행 기록이 여러 로그와 데이터베이스에 흩어지기 쉽다. 이 프로젝트는 Hermes가 실제로 디스크에 저장한 데이터를 별도 브라우저 UI로 묶어 운영 상태를 확인하고, Replay를 통해 실행 과정을 이슈나 PR에 첨부할 수 있게 한다는 점에서 관측과 공유를 한 흐름으로 연결한다.

다만 원문이 제시한 버전과 스키마를 기준으로 한 도구이므로, 자신의 Hermes 데이터 레이아웃이 다르면 Health 탭의 진단을 확인해야 한다. Replay 원격 발행은 기본적으로 꺼져 있지만, 사용자가 실행하면 정적 호스트의 공개 갤러리로 동기화할 수 있으므로 공유 전 편집 결과를 검토할 필요가 있다.

설치 예시

git clone https://github.com/joeynyc/hermes-hudui.git
cd hermes-hudui
./install.sh
hermes-hudui

후속으로 볼 링크와 키워드

백링크