← 보드로 돌아가기

Kori-x/hermes-dashboard

Dashboard for monitoring and managing Hermes agent sessions, tool usage, and activity in real-time

GitHub에서 열기 ↗ agent-frameworkai-agentsdashboarddevtoolshermesmonitoringreactreal-timetypescriptwebsocket
61
GitHub 스타
5
포크
TypeScript
언어
MIT
라이선스
2026.04.08
최근 푸시
2026.05.09
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
Hermes 에이전트를 사용하는 프로젝트에서 실시간 모니터링과 문서화를 원한다면 도입을 고려할 만합니다. 특히 에이전트의 내부 상태와 도구 사용을 시각화해야 하는 경우 유용합니다.

강점

  • Hermes 에이전트의 세션, 도구 사용, 활동을 실시간으로 모니터링할 수 있는 대시보드를 제공합니다.
  • 설치된 스킬, 플러그인, 설정, 메모리, 소울 등을 자동으로 파싱하여 검색 가능한 위키를 생성합니다.
  • Unix 소켓과 WebSocket을 활용한 효율적인 실시간 통신 구조를 갖추고 있습니다.

약점

  • README에 테스트나 CI/CD 관련 내용이 없어 안정성 검증이 부족해 보입니다.
  • 설치 스크립트(install.sh)의 구체적인 동작이나 오류 처리에 대한 설명이 없습니다.
  • 보안 관련 설정(예: 인증, HTTPS)에 대한 언급이 없습니다.

주의사항

  • 대시보드는 Hermes 에이전트에 종속적이므로 Hermes 없이 단독으로 사용할 수 없습니다.
  • Unix 소켓을 사용하므로 Windows 환경에서는 추가 설정이 필요할 수 있습니다.
  • 설치 시 `~/.hermes/` 디렉토리 구조에 의존하므로 Hermes 설치가 올바르게 되어 있어야 합니다.

시작 가이드

  • README에 명시된 대로 `git clone` 후 `./install.sh`를 실행하여 설치를 시도해 봅니다.
  • Hermes 에이전트가 설치되어 있는지 확인하고, 필요시 `HERMES_HOME` 환경 변수를 설정합니다.
  • 대시보드를 실행하여 실시간 모니터링과 위키 기능을 테스트합니다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

Hermes Dashboard

Hermes Agent를 위한 실시간 모니터링 대시보드 및 자동 생성 위키입니다.

모든 Hermes 설치에 연결할 수 있습니다. 스킬, 플러그인, 설정, 메모리, 소울을 읽어 검색 가능한 위키로 표시합니다. 라이브 대시보드는 에이전트 세션, 도구 호출, 활동을 실시간으로 보여줍니다.

설치

git clone https://github.com/Kori-x/hermes-dashboard.git
cd hermes-dashboard./install.sh

이 명령은 Hermes 플러그인, npm 종속성을 설치하고 대시보드를 빌드합니다.

사용법

대시보드를 시작합니다:

npm run dev

http://localhost:5173을 엽니다.

플러그인은 다음 세션 시작 시 Hermes에 자동 등록됩니다. 에이전트 이벤트가 실시간으로 대시보드로 스트리밍됩니다.

제공 기능

대시보드 (실시간)

  • 단계 추적(처리 중, 대기 중, 입력 대기, 승인 필요)을 포함한 에이전트 세션 모니터링
  • 모든 세션의 도구 호출, 메시지, 승인 활동 피드
  • 세션별 상세 정보: 컨텍스트 창 시각화, 도구 실행 기록, 하위 에이전트 추적
  • 세션 타임라인 및 도구 사용 분석

위키 (자동 생성)

  • 스킬 -- ~/.hermes/skills/에서 파싱된 설치된 모든 스킬, 이름/카테고리로 검색 가능
  • 플러그인 -- ~/.hermes/plugins/의 매니페스트 데이터를 포함한 설치된 플러그인
  • 도구 -- 완전한 내장 도구 참조 (10개 카테고리, 56개 도구)
  • CLI -- 플래그가 포함된 명령 참조
  • 설정 -- config.yaml을 실시간으로 렌더링
  • 메모리 -- 에이전트 메모리(MEMORY.md) 및 사용자 프로필(USER.md)
  • 소울 -- 에이전트 페르소나(SOUL.md)
  • 아키텍처 -- 핵심 루프, 공급자 해석, 메모리 시스템, 안전성, 플러그인 훅, 게이트웨이
  • 변경 로그 -- 버전 기록

서버가 실행 중일 때 위키는 ~/.hermes/에서 실시간 데이터를 읽습니다. 오프라인일 때는 내장 참조 데이터로 대체됩니다.

작동 방식

Hermes Agent
  |
  v
hermes_dashboard 플러그인 (세션 생명주기에 훅)
  |
  v
Unix 소켓 (/tmp/hermes-dashboard.sock)
  |
  v
브리지 서버 (Node.js)
  ├── WebSocket :3001 --> React 대시보드 (실시간 업데이트)
  └── HTTP :3002 ------> 위키 API (~/.hermes/ 읽기)
  |
  v
localhost:5173의 브라우저

스크립트

명령어 설명
npm run dev 대시보드 + 서버 시작 (개발 모드)
npm run dev:ui Vite만 시작
npm run dev:server 브리지 서버만 시작
npm run build 프로덕션 빌드
./install.sh 플러그인 + 종속성 설치

설정

환경 변수 기본값 설명
HERMES_HOME ~/.hermes Hermes 설치 디렉토리
HERMESDASHBOARDDIR 자동 감지 이 저장소 경로 (플러그인 자동 시작용)
HERMESAGENTNAME agent 대시보드에 표시되는 에이전트 이름

기술 스택

  • 프론트엔드: React 19, TypeScript, Vite, marked (마크다운)
  • 서버: Node.js, ws (WebSocket), Unix 도메인 소켓
  • 플러그인: Python (Hermes 훅 시스템)
  • 스타일링: 사용자 정의 CSS, 다크 테마, 고정폭 타이포그래피

라이선스

MIT

원본 저장소: Kori-x/hermes-dashboard

라이선스: MIT

게재 제외를 원하시면 삭제 요청을 보내주세요.