Hermes HUD Web UI: 영속 메모리 AI 에이전트를 브라우저에서 들여다보는 대시보드

9bow · 7월 12, 2026, 6:30오전

Hermes HUD Web UI 소개

자율적으로 도구를 호출하고 세션 사이에 기억을 유지하는 AI 에이전트를 운영하다 보면, 에이전트가 지금 무엇을 알고 있고 무엇을 하고 있는지 파악하기가 점점 어려워집니다. 어떤 모델을 얼마나 쓰고 있는지, 어떤 도구가 어디로 라우팅되는지, 메모리에 무엇이 쌓였는지가 로그와 데이터베이스에 흩어져 있기 때문입니다.

Hermes HUD Web UI 는 이런 상태를 한 화면에서 들여다볼 수 있게 해 주는 브라우저 기반 모니터링 대시보드입니다. 대상은 Hermes 로, 영속(persistent) 메모리를 가진 AI 에이전트입니다. 이 대시보드는 에이전트의 데이터 디렉토리(~/.hermes/)와 hermes CLI 를 직접 읽어, 에이전트가 디스크에 저장하는 실제 레이아웃을 그대로 추적합니다. 저자는 Hermes Agent v0.17.0(state.db 스키마 v16)을 기준으로 검증했다고 밝히고 있으며, 에이전트의 데이터가 이 기준에서 벗어나면 Health 탭이 이를 표시합니다.

이 프로젝트는 인기를 얻은 터미널 버전(hermes-hud)의 브라우저 짝으로, 같은 ~/.hermes/ 데이터를 독립적으로 읽습니다. 둘 중 하나만 쓰거나 동시에 쓸 수도 있습니다. 본 게시물에서는 Hermes HUD Web UI 가 보여주는 정보와 Hermes Replay 기능, 설치·실행 방법을 정리합니다.

Hermes HUD Web UI가 보여주는 것

Hermes HUD Web UI 는 에이전트가 자기 자신에 대해 아는 거의 모든 것을 19개의 탭으로 나눠 보여줍니다. 실행 요약 대시보드, 정체성, 메모리, 스킬, 세션, 리플레이, 크론 작업, 프로젝트, 상태 진단(health), 비용, 모델 분석, 패턴, 교정(corrections), sudo 거버넌스, 라이브 채팅, 연결된 OAuth 제공자, 게이트웨이 제어, 플러그인 관리, 라이브 모델 기능이 포함됩니다.

첫 화면인 대시보드는 실행 요약으로 열립니다. 상태(health), 지출 추이, 가장 많이 쓰는 모델, 제공자/게이트웨이 리스크, 비용이 가장 큰 세션, 그리고 조치가 필요한 항목을 한눈에 보여줍니다. 상태 정보는 파일시스템과 WebSocket 업데이트에 반응해 실시간으로 갱신되며, 비용이 큰 새로 고침 경로는 과도하게 호출되지 않도록 조절됩니다.

게이트웨이 탭은 웹 검색, 이미지 생성, 텍스트 음성 변환(TTS), 브라우저 자동화 같은 관리형 도구가 각각 Nous Tool Gateway 를 거치는지, 직접 키를 쓰는지, 아니면 사용할 수 없는 상태인지를 보여줍니다. 플러그인 허브(Plugin Hub)는 설치된 대시보드·에이전트 플러그인, 확장 진입점, 런타임 상태, 필요한 인증 명령, 그리고 활성화·비활성화·업데이트 같은 안전한 조작을 제공합니다.

Hermes Replay로 에이전트 실행을 공유 가능한 증적으로

Hermes HUD Web UI 는 에이전트의 실행 기록을 편집·공유할 수 있는 증적(proof artifact)으로 바꾸는 Hermes Replay 기능을 제공합니다. Replay 탭에서 세션을 하나 골라 정규화된 타임라인을 살펴보고, 실행 영수증(run receipt)을 검토한 뒤, 정적 산출물로 내보내 이슈나 PR 에 첨부할 수 있습니다.

기본 내보내기 형식은 편집(redacted)된 JSON 리플레이, GitHub 용 마크다운, 단독 실행 가능한 HTML 리플레이, 1200 × 630 PNG 공유 카드, 그리고 포크 안전(fork-safe) fork.json 입니다. 산출물은 기본적으로 로컬(~/.hermes-hud/replays/)에만 기록되고 어디에도 업로드하지 않습니다.

기본 내보내기 태도는 Safe Share Mode 입니다. 원시 도구 인자, 터미널 출력, 어시스턴트의 추론 과정, 토큰 형태의 값, 이메일, 로컬 경로 같은 민감한 필드를 공유 산출물에 쓰기 전에 가립니다. 내보낸 산출물에는 이 기기에서 생성한 로컬 해시와 Ed25519 서명이 담기는데, 저자는 이것이 로컬 산출물의 무결성을 증명하는 것이지 외부 제3자의 검증을 뜻하지는 않는다고 분명히 합니다. 로컬에 만든 리플레이를 정적 호스트(GitHub Pages 등)의 공개 갤러리로 동기화하는 원격 발행 기능도 있지만, 이 기능은 기본적으로 꺼져 있고 사용자가 직접 실행할 때만 동작합니다.

Hermes HUD Web UI 설치 및 실행

실행에는 Python 3.11 이상, Node.js 18 이상, 그리고 ~/.hermes/ 에 데이터가 있는 실행 중인 Hermes 에이전트가 필요합니다. 저장소를 클론한 뒤 설치 스크립트를 실행하고 대시보드를 띄우면 됩니다.

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

이후 브라우저에서 http://localhost:3001 을 열면 됩니다. 업데이트는 WebSocket 을 통해 실시간으로 반영되므로 수동 새로 고침이 필요 없습니다. 인터페이스는 영어(기본)와 중국어를 지원하고, t 키로 다섯 가지 테마(Neural Awakening, Hermes Teal, Blade Runner, fsociety, Anime)를 전환할 수 있으며, Ctrl+K 로 명령 팔레트를 엽니다. 지원 플랫폼은 macOS, Linux, WSL 입니다. 터미널 버전을 함께 쓰려면 pip install 'hermes-hudui[tui]' 로 설치할 수 있습니다.

Hermes HUD Web UI의 라이선스

Hermes HUD Web UI 는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

Hermes HUD 터미널(TUI) 버전

Hermes HUD Web UI가 모니터링하는 Hermes 에이전트

Hermes HUD Web UI 프로젝트 GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다! 텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다.

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~