Hermes WebUI

Hermes Agent를 브라우저와 모바일에서 거의 CLI 수준으로 다룰 수 있게 만드는 self-hosted 웹 인터페이스.

개요

hermes-agent 생태계에 새로 등장한 웹 운영면(web surface) 이다. nesquena/hermes-webui는 Hermes Agent의 Python 모듈을 직접 가져다 쓰는 방식으로 동작하며, 별도 프런트엔드 빌드 체인 없이 Python + vanilla JavaScript 로 구현됐다.

2026-04-26 기준 확인한 저장소 스냅샷:

  • Stars 4,196 / Forks 516 / Open issues 81
  • 기본 브랜치 master
  • 홈페이지: https://get-hermes.ai/
  • 주 언어: Python

핵심 포지션

이 프로젝트는 기존 2026-04-12-hermes-dashboard게이트웨이 관리 대시보드에 가까웠던 것과 달리, Hermes 자체를 웹에서 사용하는 거의 1:1 CLI 패리티 UI 를 지향한다.

핵심 차이는 다음과 같다.

  • 세션 목록 / 채팅 / 워크스페이스 파일 브라우저를 한 화면에 배치한 3패널 구조
  • 모델, 프로필, 워크스페이스, 토큰 사용량을 하단 컴포저에서 바로 제어
  • SSH 터널 또는 원격 접근을 전제로 한 self-hosted 웹 사용성
  • 모바일 브라우저 접근을 주요 사용 시나리오로 포함

왜 중요한가

Hermes는 본질적으로 메모리, 스킬, 크론, 메신저 게이트웨이 를 묶은 장기 실행형 에이전트인데, 그동안 접근면은 CLI나 메신저 중심이었다. Hermes WebUI는 이를 하나의 운영 콘솔로 묶어, Hermes가 단순 CLI 도구가 아니라 개인 에이전트 런타임 + 원격 운영면 으로 소비되도록 만든다.

관점에서 보면 이 저장소는 다음 흐름과 맞닿아 있다.

  • 에이전트가 장기 메모리와 자동화를 갖춘 항상 켜진 시스템 으로 이동
  • CLI 중심 워크플로우가 폰/브라우저 기반 운영면 으로 확장
  • self-hosted 에이전트 경쟁이 모델 품질뿐 아니라 운영 UI / 관측성 / 원격 접근성 으로 번지는 추세

설치 및 운영 메모

README 기준 진입점은 다음 두 가지다.

git clone https://github.com/nesquena/hermes-webui.git hermes-webui
cd hermes-webui
python3 bootstrap.py

또는 기존 설치 환경에서는:

./start.sh

부트스트랩은 Hermes Agent 설치 여부 확인, Python 환경 준비, 웹 서버 기동, /health 확인, 첫 온보딩까지 이어진다. Docker 이미지도 제공한다.

읽을 때 주의할 점

  • WebUI는 Hermes core와 직접 Python 모듈 연동 이라 버전 호환성에 민감할 수 있다.
  • 기본 사용 시나리오가 SSH 터널 / self-hosting 기반이므로, 완전한 SaaS형 웹앱과는 성격이 다르다.
  • 이 프로젝트는 2026-04-12-hermes-dashboard 의 대체라기보다, 관리 대시보드보다 더 깊게 실제 사용 세션까지 끌어올린 UI 로 보는 편이 정확하다.