Hermes Desktop(헤르메스 데스크탑) 한국어 가이드

작성일: 2026-06-04
기준: Nous Research Hermes Desktop 공개 프리뷰 (2026-06-03), Hermes Agent v0.15.2
공식 문서: Desktop App | Hermes Agent

🔗 공개 가이드 (최종 · 공유용)

이 문서를 다른 사람에게 공유할 때는 아래 Notion 링크를 사용하세요.

https://app.notion.com/p/Hermes-desktop-guide-ko-374963bb1474804cafaac003c4bce49d?source=copy_link

• 스크린샷·화면 워크스루·설정 설명은 Notion 페이지가 최신·완성본입니다.

• 이 .md 파일은 원문 백업·수정용입니다. 게시판·채팅·문서에 링크만 걸 때는 위 Notion URL을 붙여 넣으세요.

• Notion에서 Share → Publish → Publish to web 이 켜져 있어야, Notion 계정이 없는 사람도 브라우저로 볼 수 있습니다. 공유가 안 되면 Publish 탭에서 Copy web link(*.notion.site 등)를 확인하세요.

📝 한줄 요약

Hermes Desktop은 기존 Hermes Agent(CLI·Telegram 게이트웨이)와 같은 에이전트 코어를 쓰는 네이티브 GUI입니다. 설정·세션·스킬·메모리를 ~/.hermes(Windows: %LOCALAPPDATA%\hermes)에서 공유하므로, 데스크탑에서 시작한 작업을 Telegram·CLI에서 그대로 이어갈 수 있습니다. 해당 가이드는 로컬llm qwen 3.5 9B로 깍고 깍아 작성하였습니다.

1. Hermes Desktop이란?

핵심: 별도 제품이 아니라, 터미널 없이도 쓸 수 있는 또 하나의 앞면(UI) 입니다.

2. 설치 방법

방법 A — 설치 프로그램 (macOS / Windows, 권장)

1. Hermes 공식 사이트에서 Desktop 설치 파일 다운로드

2. 설치 후 실행

방법 B — CLI로 한 줄 실행 (이미 Hermes 설치된 경우)

hermes desktop

• 기존 ~/.hermes 설정·API 키·세션·스킬을 그대로 사용합니다.

• Telegram 게이트웨이를 쓰고 있었다면, 데스크탑에서도 같은 세션 목록이 보입니다.

방법 C — 신규 설치 시 Desktop 포함 (Linux 등)

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --include-desktop

유용한 CLI 플래그

업데이트

hermes update

앱 내에서도 백그라운드 업데이트 알림이 올 수 있습니다. 공식 최신은 v0.15.2 — 화면에 v0.15.1이 보이면 한 번 올려 두는 것을 권장합니다.

로컬 LLM 연결 시 (LM Studio / Ollama 등)

Hermes Agent는 최소 64K 컨텍스트를 요구합니다.

8GB VRAM에서는 64K가 빠듯할 수 있어, 양자화·오프로딩을 함께 조정해야 할 수 있습니다.

3. 데스크탑(GUI) vs 기존 터미널(CLI/TUI) — 항목별 비교

같은 에이전트 코어를 GUI 클릭으로 다루느냐, 명령어·설정 파일로 다루느냐의 차이입니다.

언제 무엇을 쓰면 좋은가

GUI가 유리한 경우

• 여러 세션·스킬·메신저 채널을 한 화면에서 관리

• 파일 브라우저·미리보기·Artifacts로 에이전트 작업 추적

• Cron·프로필·API Keys를 클릭으로 설정

터미널이 유리한 경우

• 서버·SSH·스크립트 자동화

• 빠른 한 줄 명령·로그 tail (hermes logs gui -f)

• CI·headless 환경

둘을 함께 쓰는 방법

1. 데스크탑에서 세션 시작 → Telegram·CLI에서 같은 세션 재개

2. Remote gateway: 집 PC의 Hermes 백엔드를 VPS·Tailscale 뒤에 두고 데스크탑만 원격 연결 (Settings → Gateway)

4. 화면 한눈에 보기 (실제 레이아웃)

(여기에 첫 화면 스크린샷 삽입 — 세션 제목·홈 폴더 경로는 가림)

단축키: New session — Ctrl+N

5. 화면별 상세 가이드

5.1 🧩 Skills & Tools

(스크린샷: 좌측 세션 목록은 잘라내고 Skills 화면만 — images/02-skills-tools.png)

역할: 설치된 스킬(Skills) 을 검색·필터·ON/OFF 로 관리합니다. 스킬은 에이전트가 특정 작업을 더 잘하도록 묶인 능력 패키지입니다.

화면 예시 (카테고리·이름만, 토글은 환경마다 다름)

💡 팁: 스킬을 너무 많이 켜면 컨텍스트·지연·비용이 늘 수 있습니다. 프로젝트별로 필요한 것만 켜 두세요.

5.2 💌 Messaging

(스크린샷: 봇 토큰·허용 사용자 ID는 반드시 가림 — images/03-messaging.png)

역할: Hermes 게이트웨이가 어떤 메신저에서 동작할지 연결·자격증명을 설정합니다.

Telegram 설정 예시

🔒 보안: Allowed user IDs 없이 봇을 열어두면 누구나 봇에 메시지를 보낼 수 있습니다. 본인 ID만 허용하는 것을 권장합니다.

하단 상태 바: 컨텍스트 게이지(예: 0/65.5k), 세션 토큰 표시 — 긴 대화일수록 컨텍스트가 차오릅니다.

5.3 🗂️ Artifacts

(스크린샷: 파일 경로·GitHub 계정·저장소 URL은 가림 — 직접 캡처 삽입 권장)

역할: 에이전트가 만들거나 참조한 산출물(파일·이미지·링크)을 한곳에 모은 카탈로그입니다.

LOCATION 접두어 예: /OUT, /DEF, /IMPLIB — 빌드·링크 산출물 구분

💡 행을 클릭하면 열기·미리보기. SESSION 열로 어떤 대화에서 나온 파일인지 역추적할 수 있습니다.
컨텍스트 게이지가 높을 때(예: 84%) — 대화·도구 출력이 컨텍스트를 많이 쓰고 있다는 신호입니다.

5.4 📌 PINNED — 세션 고정

세션이 수십 개일 때 핵심 작업(배포, 데이터 변환 등)만 위에 고정해 두면 전환 속도가 빨라집니다.

5.5 📁 File Browser (파일 시스템)

(스크린샷: 사용자 홈 폴더·계정명은 가림 — 직접 삽입)

역할: 에이전트 작업 디렉터리를 앱 안에서 트리로 탐색·미리보기합니다.

활용

• 에이전트가 읽기·쓰기·수정하는 파일을 실시간으로 따라가기

• 프로젝트마다 hermes desktop --cwd <프로젝트경로> 로 루트 지정

⚠️ 외부 공유 시 스크린샷에서 홈 경로·다운로드·문서 폴더명은 가리세요.

5.6 💻 Shell (터미널)

역할: 우측 패널 상단에서 File Browser ↔ Shell 전환. 실제 OS 셸(Windows: cmd 등)이 동작하며, 에이전트와 같은 작업 디렉터리·환경을 공유합니다. 전체화면 지원.

활용 예시

# Git — 에이전트 변경분 검토 후 직접 커밋
git status
git diff
git add . && git commit -m "message"

# 실행·테스트
python app.py
pytest
npm run dev
npm run build

# 배포
vercel --prod

# 패키지
pip install <package>
npm install

# 환경 점검
dir
cd <project>
python --version
where python

# Hermes 관리
hermes update
hermes logs gui -f

# 로컬 LLM
ollama list

워크플로: 에이전트가 코드 작성 → Shell에서 즉시 실행·검증 → 결과를 채팅에 피드백

⚠️ rm, format, 대량 pip uninstall, git push --force 등은 실행 전 한 번 더 확인하세요.

5.7 🎛️ Command Center

열기: 상단 또는 단축으로 Command Center — 세션·시스템·사용량을 한 창에서 관리합니다.

Sessions 뷰

(세션 제목·날짜는 가린 캡처 권장)

💡 사이드바 세션 목록 = 빠른 전환. Command Center Sessions = 검색·정리·보내기·삭제에 적합.

System 뷰

Usage 뷰

(개인 세션 수·토큰 수·비용·TOP 모델 목록은 캡처에서 제외)

💡 로컬 모델은 비용이 0에 가깝습니다. Usage는 순수 사용량·스킬 정리 참고용으로 유용합니다.

5.8 🔌 Gateway 상태 (하단 상태 바)

열기: 하단 Gateway ready 클릭

진단: 봇 무응답·추론 불가 시 — 게이트웨이 vs 모델 vs 메신저 중 어디가 끊겼는지 1차 확인.

5.9 🌿 Agent Spawn Tree (Agents)

열할: 하단 Agents 클릭

5.10 ⏰ Cron (예약 작업)

역할: 자연어 또는 cron 문법으로 예약 프롬프트 실행. 결과를 데스크탑·Telegram·Discord·Slack·Email 등으로 전달.

New cron job 모달

목록 행 액션 (좌→우)

활용 예

• 매일 아침 요약 → Deliver to: Telegram (PC를 안 켜도 모바일 수신)

• 주간 백업·리포트 프롬프트

• 공개 API·데이터 정기 점검

5.11 🧠 모델 선택 & 관리

(모델 토글 상태·키 개수는 캡처에서 제외)

① 모델 선택기 (하단 드롭다운)

• Search models

• 프로바이더 그룹 (예: LM STUDIO = 로컬, OPENAI-API = 클라우드)

• 현재 모델 ✓ 표시

• 맨 아래 Edit Models…

② Edit Models

• 목록에 노출할 모델 토글 ON/OFF

• Add provider…

③ API Keys (설정 → API Keys)

• 좌측: Model, Chat, Appearance, Safety, MCP, Archived Chats 등

• N of M configured — 몇 개 프로바이더에 키가 있는지

• 프로바이더별 키 입력·Import/Export

• 예: Nous Portal, Anthropic, Gemini, DeepSeek, OpenRouter 등

🔒 API Keys 화면 캡처는 절대 그대로 공개하지 마세요.

5.12 👤 Profiles & SOUL.md

역할: 프로필 = 페르소나·모델·스킬·SOUL.md 를 묶은 독립 환경. 업무 / 개발 / 글쓰기 등 맥락별로 전환합니다.

Profiles 팝업

• 프로필 목록·요약

• Manage profiles

Manage profiles 창

SOUL.md란?

• 프로필별 시스템 프롬프트·페르소나

• 매 메시지마다 다시 로드 (앱 재시작 불필요)

• 비우면 기본 성격

활용 예시

Copy setup — 다른 프로필 설정을 복제해 시작할 때 유용합니다.

5.13 ⚙️ Settings (톱니바퀴) — 전체 설정

설정 창 좌측 패널 기준 요약입니다.

MCP (Model Context Protocol) — 예시

외부 도구·데이터를 표준 프로토콜로 연결합니다. Server JSON 형태로 등록합니다.

파일시스템 서버 예시

{
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/folder"]
}

시간 유틸 (stdio) 예시

{
  "command": "uvx",
  "args": ["mcp-server-time"]
}

실제 사용 시 각 서버 공식 문서의 command·args·env를 확인하세요. 잘못된 경로는 에이전트가 의도치 않은 디렉터리에 접근하게 할 수 있습니다.

Remote gateway (요약)

• 기본: 앱이 로컬 백엔드 자동 기동

• 원격: VPS·홈서버·Tailscale 뒤 hermes dashboard --tui + 고정 HERMES_DASHBOARD_SESSION_TOKEN

• 상세: 공식 문서 — Connecting to a remote backend

6. 문제 해결

부팅·백엔드 실패

hermes logs gui -f

로그: HERMES_HOME/logs/desktop.log

macOS/Linux — 첫 실행·venv 리셋

rm "$HOME/.hermes/hermes-agent/.hermes-bootstrap-complete"
rm -rf "$HOME/.hermes/hermes-agent/venv"

Gateway / Telegram 무응답

1. 하단 Gateway 팝업 → Connection·MESSAGING PLATFORMS

2. Messaging → Telegram Enabled·토큰·Allowed user IDs

3. hermes logs gui -f 에서 게이트웨이 오류 확인

Remote gateway — 연결은 되는데 채팅만 안 됨

• 백엔드를 hermes dashboard --tui 로 실행했는지 확인 (--tui 없으면 status는 OK인데 WebSocket 거부)

7. Notion 공개 페이지 · 외부 공유

7.1 최종 공개 링크 (공유용)

GPTERS·Telegram·블로그 등에 올릴 때는 위 링크 한 줄이면 됩니다.

7.2 Notion에서 공개 범위 확인

1. 가이드 페이지 열기

2. 우측 상단 Share → Publish 탭

3. Publish to web 켜기

4. Copy web link 로 복사 (로그인 없이 보기용 URL — notion.site 도메인일 수 있음)

5. 권장: Allow editing 끄기 · 필요 시 검색 색인만 조정

app.notion.com/p/... 링크는 워크스페이스·게시 설정에 따라 동작이 다를 수 있습니다. 외부인이 “권한 없음”이면 Publish to web 과 Copy web link URL을 함께 안내하세요.

7.3 로컬 md로 Notion 수정·동기화 (선택)

가이드를 텍스트로 다시 올리거나 백업할 때:

방법 1 — Import (이미지 포함 시)

1. Notion → Import → Markdown & CSV

2. HERMES_DESKTOP_GUIDE_2026-06-04.md + images/ 를 zip으로 업로드

방법 2 — 붙여넣기

1. md 본문 복사 → 기존 Notion 페이지에 붙여넣기

2. 스크린샷·images/… 자리 보완

7.4 공개 전 개인정보 체크리스트

Notion 웹 게시 시 기여자 이름·이메일이 메타데이터에 포함될 수 있습니다. 실명 노출이 곤란하면 워크스페이스 표시 이름을 조정한 뒤 게시하세요.

8. 이미지 폴더 안내 (선택)

가이드에 참조한 파일명 예시:

images/
  01-main-layout.png      ← 직접 삽입 권장 (개인정보 많음)
  02-skills-tools.png
  03-messaging.png        ← 토큰 가림 필수
  04-pinned.png
  05-command-center-system.png
  06-gateway.png
  07-spawn-tree.png
  08-cron-new.png
  09-profiles.png
  10-settings-appearance.png
  11-settings-safety.png
  12-settings-mcp.png
  13-settings-gateway.png

이전 작업에서 개인정보를 제거·크롭한 13장을 images/에 넣고 zip으로 Import하면 본문과 함께 붙습니다. 없는 항목은 Notion에서 직접 업로드하세요.

9. 참고 링크

10. 마무리

• Hermes Desktop = 같은 ~/.hermes · 같은 세션 · 같은 Telegram 봇에 GUI를 더한 것

• CLI/Telegram만 쓰던 분 → hermes desktop 한 줄로 전환 가능

• 화면 워크스루: 시작 → Skills & Tools → Messaging → Artifacts → PINNED → File Browser → Shell → Command Center → Gateway → Spawn Tree → Cron → 모델·프로필·Settings

• 외부 공유 → Hermes Desktop Guide (KO) — Notion