Hermes Workspace — Native Web Workspace for Hermes Agent

Hermes Agent를 위한 네이티브 웹 작업공간. 채팅, 터미널, 메모리, 스킬, 파일, 인스펙터를 한 화면에 통합한다.

한 줄 요약

hermes-workspace는 Hermes Agent용 컨트롤 센터 UI다. 단순한 채팅 래퍼가 아니라, 에이전트 상태·메모리·스킬·파일·터미널을 한곳에서 다루는 실전형 워크스페이스를 지향한다.

핵심 특징

  • 실시간 SSE 채팅: Hermes Agent와 연결해 스트리밍 응답 및 tool call 렌더링 지원
  • 메모리/스킬 브라우저: 메모리 파일 탐색·검색·편집, 2,000+ 스킬 브라우징
  • 파일 브라우징 + Monaco 편집기: 디렉토리 탐색과 파일 편집을 한 화면에서 처리
  • 내장 터미널: PTY 기반 지속 세션 지원
  • Inspector 패널: 세션·잡·tool 실행 관찰
  • 모바일 우선 PWA: 휴대폰에서도 작업 가능한 UI
  • 보안 하드닝: auth middleware, CSP, exec 승인 프롬프트, path traversal 방지, rate limit, fail-closed startup guard, secure cookies
  • 2가지 동작 모드:
    • Portable mode — OpenAI-compatible backend 직접 연결
    • Enhanced mode — Hermes gateway/dashboard와 연결해 풀 기능 사용

왜 중요한가

이 저장소는 Hermes Agent 생태계에서 웹 기반 작업면을 담당한다. 즉, Hermes Agent를 CLI 중심 도구에서 chat + memory + skills + terminal + files를 갖춘 실제 작업공간으로 확장한다. 이 추적 중인 hermes-agent2026-04-26-hermes-webui와 같은 축선상에 있다.

설치 / 실행 흐름

README 요약 기준:

curl -fsSL https://raw.githubusercontent.com/outsourc-e/hermes-workspace/main/install.sh | bash

설치 스크립트는:

  • hermes-agent를 PyPI에서 설치
  • 저장소 clone
  • .env 설정
  • 의존성 설치

실행 예:

hermes gateway run
cd ~/hermes-workspace && pnpm dev

기본 주소:

http://localhost:3000

요구사항

  • Node.js 22+
  • OpenAI-compatible backend
  • 선택: 로컬 Hermes gateway용 Python 3.11+

관련성

  • Hermes Agent: 실행 백엔드 / 상태 소스
  • Hermes Workspace: 웹 UI / 작업면
  • Hermes Dashboard: 관리·설정 면
  • Hermes WebUI: 유사 UI 계열, 다만 이 프로젝트는 좀 더 작업공간 전체를 묶는 느낌

관련 노트

핵심 인사이트

  1. Zero-fork 철학: vanilla NousResearch/hermes-agent 위에 얹어 drift를 줄인다.
  2. 작업공간 통합: agent-native UI가 단순 채팅보다 훨씬 유용하다.
  3. 보안 우선: 워크스페이스형 UI는 exec approval / path protection / auth hardening이 필수다.
  4. Hermes 생태계의 중심 후보: Hermes Agent를 실제로 쓰게 만드는 프론트엔드 계층으로 의미가 크다.