영문 안내: README.en.md
Hermes for Web 은 Hermes Agent 를 위한 브라우저 작업실입니다.
쉽게 비유하면:
- Hermes CLI 가 엔진룸이라면, Hermes for Web 은 조종석입니다.
- 텔레그램 구찌가 무전기라면, Hermes for Web 은 관제탑입니다.
- Obsidian 이 책장이라면, Hermes for Web 은 책상입니다.
즉, 그냥 “AI와 대화하는 웹페이지”가 아니라, 작업을 만들고, 점검하고, 저장하고, 이어서 공유하는 작업 공간에 가깝습니다.
이 포크의 핵심 방향은 다음과 같습니다.
- 한국어 친화 UI
- 초보자도 바로 쓰기 쉬운 워크플로우 버튼
- 각 사용자 Hermes memory 를 읽는 개인화 시작 화면
- Darwin 같은 로컬 모델과 GPT 계열 원격 모델의 공존
- WebUI 안에서 아티팩트 생성/관리
- Obsidian / ShareNote / Telegram 흐름을 빠르게 붙일 수 있는 Setup Packs
==================================================
보통 AI 웹 UI 는 채팅창 + 모델 선택기 정도에서 끝나는 경우가 많습니다. Hermes for Web 은 그보다 한 걸음 더 나아가려고 합니다.
이 UI 로 하고 싶은 것:
- Hermes 와 대화하기
- 노트/브리프/메모 같은 결과물 만들기
- 자주 쓰는 환경을 원클릭으로 세팅하기
- 실행 전에 품질을 간단 점검하기
- 사용자의 기억을 읽어 점점 자기화된 작업실로 만들기
한 문장으로 말하면: 이건 “질문하고 답받는 UI”보다, “내 작업 방식을 점점 배워가는 AI 작업실”에 더 가깝습니다.
==================================================
이런 분들께 특히 잘 맞습니다.
- Hermes CLI 를 이미 쓰는데 더 보기 쉬운 웹 UI 가 필요한 사람
- Obsidian 중심으로 일하는 사람
- 텔레그램/CLI/WebUI 를 오가며 같은 AI를 쓰고 싶은 사람
- 리서치, 글쓰기, 노트 작성, 자동화까지 한곳에서 하고 싶은 사람
- 로컬 모델(Darwin 등)과 원격 모델(GPT 계열)을 함께 쓰고 싶은 사람
==================================================
이 포크는 사용자의 Hermes memory 와 user profile 을 읽어서 시작 화면을 조금씩 개인화합니다.
비유하면:
- 일반 챗봇 UI 는 카페에서 처음 보는 손님을 대하듯 모두에게 똑같이 반응합니다.
- Hermes for Web 은 단골 손님을 알아보는 카페처럼, 사용자의 기억을 바탕으로 더 자연스럽게 시작하려고 합니다.
현재 방향:
/api/memory를 읽음- 홈 화면에 개인화 카드 표시
- 사용자 기억이 있으면 그 내용을 바탕으로 “이 작업실은 당신에 맞게 커질 수 있다”는 경험 제공
즉, 특정 한 사람 전용 UI 가 아니라, 각 사용자의 Hermes memory 를 읽어 각자에게 맞게 반응하는 범용 UI 를 지향합니다.
이 포크의 기본 테마는 벚꽃(Cherry Blossom)입니다.
왜냐하면 첫 화면의 인상은 제품의 악수와 같기 때문입니다. 처음 열었을 때 차갑고 딱딱한 느낌보다, 부드럽고 기억에 남는 감성을 주는 편이 좋다고 판단했습니다.
현재 포함된 테마:
- Cherry Blossom (기본값)
- Neo Brutalism
- Gucci style
추가 요소:
- 벚꽃 꽃잎 애니메이션
- 헤더/사이드바 주변 sakura 장식 이미지
Setup Pack 은 “설치/설정 레시피 카드”입니다.
보통은 사용자가 이렇게 해야 합니다:
- 이 도구 설치하고
- 저 설정 확인하고
- 이 플러그인 켜고
- 이 명령어 기억해두고
- 최종적으로 어떤 흐름으로 쓰는지 익혀야 함
Setup Pack 은 이걸 줄여줍니다. 즉, “무슨 걸 설치해야 하지?”를 줄이고, “이 버튼 누르면 Hermes 가 환경을 점검하고 세팅을 도와주는” 방향으로 갑니다.
현재 포함된 팩:
- Obsidian Starter Pack
- ShareNote + Telegram Pack
- Obsidian Power Workflow
- Memory Sync Pack
Artifacts 는 결과물입니다.
쉽게 말해: 채팅이 말이라면, artifact 는 남는 작업물입니다.
예:
- note
- posting brief
- brief
- memo
- research brief
이 UI 에서는 아티팩트를:
- 만들고
- 열고
- 삭제하고
- Share / Telegram / Memory 액션과 연결할 수 있습니다.
즉 “대화”를 “파일”과 “결과물”로 바꾸는 층입니다.
Preflight 는 비행기 이륙 전 체크리스트 같은 기능입니다.
작업을 실행하기 전에, “이 상태로 하면 너무 허술하지 않은가?”를 가볍게 점검합니다.
현재 점검 대상:
- note
- posting
- cron
이건 아직 가벼운 MVP 이지만, 사용자 입장에선 “실행해보고 망하는 것”보다, “실행 전에 한번 점검받는 것”이 훨씬 편합니다.
==================================================
- Darwin 같은 로컬 모델 사용 가능
- GPT-5.4 / GPT-5.4 Mini / Codex 계열 사용 가능
- 세션 단위 모델 전환
- 로컬 모델과 원격 모델을 함께 쓰는 구조
- 현재 세션의 작업 파일 탐색
- markdown / code / image 미리보기
- 파일/폴더 생성
- 결과물을 실제 파일처럼 다루기
- artifact shelf
- 아티팩트 생성 모달
- 생성 / 열기 / 삭제
- AI 후속 보조
- 아티팩트에서 바로:
- Share
- Telegram
- Memory 로 연결 가능
- 자주 쓰는 workflow 를 원클릭 bootstrap
- 실행 이력 표시
- 재실행 / 상태 변경 가능
- note check
- posting check
- cron check
- 실행 전 간단한 readiness 점검
- 한국어 중심 UI
- 벚꽃 기본 테마
- 벚꽃 장식 / 꽃잎 애니메이션
- 파비콘
- 사이드바 중심 tool organization
==================================================
- 메인 채팅: Hermes 와 생각을 정리하는 공간
- 사이드바 도구 패널: 기능을 관리하는 서랍장
- Workspace: 실제 파일과 결과물을 보는 작업대
- Artifact shelf: 대화를 결과물로 바꾸는 선반
- Setup Packs: 설치/설정을 쉽게 시작하는 레시피 카드
- Preflight: 실행 전 “한 번 보고 가자” 체크리스트
==================================================
먼저 Hermes Agent 가 설치되어 있어야 합니다.
git clone https://github.com/reallygood83/hermes-for-web.git
cd hermes-for-web
./start.sh 8788그 다음 브라우저에서:
http://localhost:8788
이 프로젝트는 사용자를 “설명서와 씨름하게” 만들기보다, “이미 준비된 작업실에 들어가게” 만들고 싶습니다.
그래서 기본 원칙은:
- 가능한 자동 탐지
- 기존 Hermes memory / config 재사용
- 조용히 시스템을 바꾸기보다 guided flow 제공
- Setup Pack 으로 환경 부팅 보조
즉 “부품 상자”보다 “정리된 책상”에 가깝게 만드는 것이 목표입니다.
==================================================
Obsidian 중심으로 시작하고 싶은 사람용입니다.
주요 목표:
- vault 확인
- note 작성 흐름 점검
- Obsidian 친화 markdown workflow 확인
노트를 만들고, 공유 링크를 만들고, 텔레그램까지 이어지는 흐름을 점검하고 싶은 사람용입니다.
주요 목표:
- ShareNote 플러그인/흐름 확인
- 공유 링크 생성 흐름 점검
- Telegram handoff 흐름 정리
다음을 한 번에 엮고 싶은 사람용입니다.
- note
- posting
- ShareNote
- Telegram handoff
CLI / WebUI / Telegram 간의 감각적인 연결을 강화하고 싶은 사람용입니다.
==================================================
Artifacts 는 채팅을 작업물로 바꾸는 기능입니다.
아티팩트 모달에서 만들 수 있는 유형:
- Note
- Posting Brief
- Brief
- Memo
- Research Brief
“AI 도움 프롬프트도 함께 준비”를 체크하면, 파일 생성 직후 Hermes 가 그 아티팩트를 더 다듬을 수 있도록 입력창에 적절한 프롬프트를 넣어줍니다.
생성된 아티팩트는:
- 열기
- 삭제
- Share
- Telegram
- Memory 액션으로 이어집니다.
즉 아티팩트는 단순 파일이 아니라, 다음 workflow 로 연결되는 발판입니다.
==================================================
Preflight 는 “하기 전에 한번 보는 기능”입니다.
예를 들면:
- note 만들기 전에 note 구조가 괜찮은지
- posting 전에 핵심 메시지가 있는지
- cron 전에 schedule 과 prompt 가 너무 비어있지 않은지
이건 아직 가벼운 버전이지만, 사용자가 실수하기 전에 경고해주는 안전장치 역할을 합니다.
==================================================
초기에는 메인 화면에 카드가 너무 많이 쌓여서 복잡해졌습니다. 그건 마치 작업 책상 위에 모든 도구를 한꺼번에 늘어놓은 것과 비슷합니다.
그래서 지금은
- 아티팩트
- 설치팩
- 점검 같은 관리 기능을 사이드바 중심으로 옮겼습니다.
덕분에:
- 메인 화면은 더 깔끔해지고
- 필요한 도구는 왼쪽에서 바로 꺼내 쓰는 구조가 됐습니다.
==================================================
이 포크를 만든 사람의 작업 맥락을 보고 싶다면:
- YouTube: https://www.youtube.com/@%EB%B0%B0%EC%9B%80%EC%9D%98%EB%8B%AC%EC%9D%B8-p5v
- X: https://x.com/reallygood83
README 상단 배지에도 같은 링크가 있습니다.
==================================================
추천 저장소:
처음엔 private 으로 올리고, 그 다음 깨끗한 머신에서 검증 후 공개 여부를 결정하는 게 좋습니다.
검증 추천 항목:
- Darwin 이 WebUI 에서 정상 응답하는지
- GPT 계열 모델도 정상 응답하는지
- Cherry Blossom 이 기본값인지
- memory 가 있을 때 personalization 카드가 잘 뜨는지
- memory 가 없어도 UI 가 깨지지 않는지
- Setup Packs 가 실행되는지
- Artifact 생성/열기/삭제가 되는지
- 사이드바 패널이 자연스럽게 렌더링되는지
이건 “내 컴퓨터에서는 되는데 남한테는 안 되는” 상황을 줄이기 위한 과정입니다.
==================================================
private repo 올린 뒤에는 이렇게 가는 걸 추천합니다.
- private repo push
- 다른 Hermes 사용자 1명 이상에게 테스트 받아보기
- Setup Packs / Artifact / Preflight 중 어디가 헷갈렸는지 확인
- README 와 첫 화면 copy 를 더 쉽게 다듬기
- 그 다음 공개 전환 검토
좋은 제품은 설명을 덜 필요로 합니다. 훌륭한 제품은 사용자가 “원래 이랬어야 하는데?”라고 느끼게 만듭니다. 이 포크는 그 방향을 목표로 합니다.
==================================================
이 저장소는 Hermes WebUI 기반의 workflow-focused fork 입니다. 나중에 public 으로 열 경우, 업스트림 크레딧과 포크에서 추가한 기능을 명확히 적는 것을 권장합니다.