Hermes Desktop(헤르메스 데스크탑) 한국어 가이드
2026.06.04
작성일: 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) | |
공유 URL (복사용) |
|
스크린샷·화면 워크스루·설정 설명은 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이란?
항목 | 설명 |
|---|---|
제작 | Nous Research |
공개 | 2026년 6월 3일 공개 프리뷰 |
플랫폼 | macOS 12+, Windows 10/11, Linux |
라이선스 | MIT (오픈소스) |
빌드 | Hermes Agent v0.15.2 기준 |
관계 | CLI( |
핵심: 별도 제품이 아니라, 터미널 없이도 쓸 수 있는 또 하나의 앞면(UI) 입니다.
2. 설치 방법
방법 A — 설치 프로그램 (macOS / Windows, 권장)
Hermes 공식 사이트에서 Desktop 설치 파일 다운로드
설치 후 실행
방법 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 소스 루트 지정 |
업데이트
hermes update앱 내에서도 백그라운드 업데이트 알림이 올 수 있습니다. 공식 최신은 v0.15.2 — 화면에 v0.15.1이 보이면 한 번 올려 두는 것을 권장합니다.
로컬 LLM 연결 시 (LM Studio / Ollama 등)
Hermes Agent는 최소 64K 컨텍스트를 요구합니다.
백엔드 | 설정 예시 |
|---|---|
llama.cpp |
|
Ollama |
|
8GB VRAM에서는 64K가 빠듯할 수 있어, 양자화·오프로딩을 함께 조정해야 할 수 있습니다.
3. 데스크탑(GUI) vs 기존 터미널(CLI/TUI) — 항목별 비교
같은 에이전트 코어를 GUI 클릭으로 다루느냐, 명령어·설정 파일로 다루느냐의 차이입니다.
항목 | Hermes Desktop (GUI) | 터미널 (CLI / TUI) |
|---|---|---|
진입 | 설치 프로그램 또는 |
|
설정·상태 |
| 동일 |
채팅 | 중앙 패널, 스트리밍·도구 호출 요약 | TUI 텍스트 UI |
파일 첨부 | 채팅 영역 드래그앤드롭 | 경로·명령으로 지정 |
모델 전환 | 하단 모델 선택기 드롭다운 | 설정·명령 |
파일 탐색 | 우측 File Browser 트리 |
|
셸 | 우측 Shell 패널 (OS 셸 임베디드) | 동일 터미널 또는 외부 터미널 |
스킬 | Skills & Tools UI 토글 | 스킬 파일·설정 |
메신저 | Messaging UI | 게이트웨이 설정 |
Cron | Cron UI + New cron 모달 |
|
프로필 | Profiles + SOUL.md 편집기 | 프로필 디렉터리 |
설정 | 톱니바퀴 12개 패널 | YAML·환경변수 |
Artifacts | 산출물 카탈로그 테이블 | 세션·파일 직접 탐색 |
사용량 | Command Center → Usage | 로그·외부 도구 |
음성 | Voice 설정·마이크 | 동일 기능 (플랫폼별) |
리소스 | Electron + 로컬 백엔드 | 가벼움 |
원격 | Settings → Gateway → Remote | VPS에서 |
언제 무엇을 쓰면 좋은가
GUI가 유리한 경우
여러 세션·스킬·메신저 채널을 한 화면에서 관리
파일 브라우저·미리보기·Artifacts로 에이전트 작업 추적
Cron·프로필·API Keys를 클릭으로 설정
터미널이 유리한 경우
서버·SSH·스크립트 자동화
빠른 한 줄 명령·로그 tail (
hermes logs gui -f)CI·headless 환경
둘을 함께 쓰는 방법
데스크탑에서 세션 시작 → Telegram·CLI에서 같은 세션 재개
Remote gateway: 집 PC의 Hermes 백엔드를 VPS·Tailscale 뒤에 두고 데스크탑만 원격 연결 (Settings → Gateway)
4. 화면 한눈에 보기 (실제 레이아웃)
(여기에 첫 화면 스크린샷 삽입 — 세션 제목·홈 폴더 경로는 가림)
영역 | 위치 | 역할 |
|---|---|---|
① 좌측 내비 | 왼쪽 아이콘 열 | New session, Skills & Tools, Messaging, Artifacts 등 |
② 세션 목록 | 내비 아래 | 데스크탑·CLI·Telegram 세션 통합, |
③ 중앙 채팅 | 가운데 | HERMES AGENT 시작 화면, 메시지·스트리밍, Send follow-up(음성·전송) |
④ 우측 패널 | 오른쪽 | File Browser ↔ Shell 전환, 작업 디렉터리 트리 |
⑤ 하단 상태 바 | 맨 아래 | Gateway ready, Agents, Cron, 모델 선택기, 버전 |
⑥ 상단 | 우측 | 윈도우 컨트롤, Command Center, 프로필, 설정 |
단축키: New session — Ctrl+N
5. 화면별 상세 가이드
5.1 🧩 Skills & Tools
(스크린샷: 좌측 세션 목록은 잘라내고 Skills 화면만 — images/02-skills-tools.png)
역할: 설치된 스킬(Skills) 을 검색·필터·ON/OFF 로 관리합니다. 스킬은 에이전트가 특정 작업을 더 잘하도록 묶인 능력 패키지입니다.
UI 요소 | 설명 |
|---|---|
Search skills… | 이름·설명 검색 |
Skills / Toolsets | 스킬 목록 vs 도구 묶음 설정 탭 |
카테고리 필터 | All, Automation, Creative, Devops, Github, Software-Development 등 (숫자 = 해당 카테고리 스킬 수) |
목록 한 줄 | 스킬 이름 + 한 줄 설명 + 우측 토글 |
화면 예시 (카테고리·이름만, 토글은 환경마다 다름)
카테고리 | 스킬 예시 | 설명 요지 |
|---|---|---|
Automation | external-notifications | cron·웹훅으로 Telegram/Discord/Slack 등 알림 |
Autonomous-AI-Agents | claude-code, codex, opencode | 외부 코딩 CLI에 작업 위임 |
Autonomous-AI-Agents | hermes-agent | Hermes 자체 설정·확장 |
Autonomous-AI-Agents | kanban-codex-lane | Codex 격리 레인 + Hermes 검증·핸드오프 |
Creative | architecture-diagram | SVG 아키텍처 다이어그램 HTML |
Creative | ascii-art | pyfiglet·cowsay 등 |
💡 팁: 스킬을 너무 많이 켜면 컨텍스트·지연·비용이 늘 수 있습니다. 프로젝트별로 필요한 것만 켜 두세요.
5.2 💌 Messaging
(스크린샷: 봇 토큰·허용 사용자 ID는 반드시 가림 — images/03-messaging.png)
역할: Hermes 게이트웨이가 어떤 메신저에서 동작할지 연결·자격증명을 설정합니다.
영역 | 설명 |
|---|---|
왼쪽 목록 | Telegram, Discord, Slack, WhatsApp, Signal, Email, SMS(Twilio), WeChat, QQ Bot 등 |
상태 점 | 연결·자격증명 여부 표시 |
오른쪽 패널 | 선택한 플랫폼 설정 |
Telegram 설정 예시
필드 | 설명 |
|---|---|
Bot token | @BotFather |
Allowed user IDs | 허용할 사용자 ID 화이트리스트 (권장) |
Advanced | 추가 옵션 |
Enabled | 채널 활성화 토글 |
Save changes | 저장 |
🔒 보안: Allowed user IDs 없이 봇을 열어두면 누구나 봇에 메시지를 보낼 수 있습니다. 본인 ID만 허용하는 것을 권장합니다.
하단 상태 바: 컨텍스트 게이지(예: 0/65.5k), 세션 토큰 표시 — 긴 대화일수록 컨텍스트가 차오릅니다.
5.3 🗂️ Artifacts
(스크린샷: 파일 경로·GitHub 계정·저장소 URL은 가림 — 직접 캡처 삽입 권장)
역할: 에이전트가 만들거나 참조한 산출물(파일·이미지·링크)을 한곳에 모은 카탈로그입니다.
UI 요소 | 설명 |
|---|---|
검색 | 제목·이름 검색 |
타입 필터 | All / Images / Files / Links (개수 표시) |
카운트 | 예: |
테이블 컬럼 | TITLE/NAME, LOCATION(경로·URL), SESSION(생성 세션·일시) |
LOCATION 접두어 예: /OUT, /DEF, /IMPLIB — 빌드·링크 산출물 구분
💡 행을 클릭하면 열기·미리보기. SESSION 열로 어떤 대화에서 나온 파일인지 역추적할 수 있습니다.
컨텍스트 게이지가 높을 때(예: 84%) — 대화·도구 출력이 컨텍스트를 많이 쓰고 있다는 신호입니다.
5.4 📌 PINNED — 세션 고정
항목 | 설명 |
|---|---|
역할 | 중요한 대화를 SESSIONS 목록 위에 항상 노출 |
고정 | 세션에서 Shift + 클릭 |
순서 | 드래그로 재정렬 |
비어 있을 때 | 안내 문구만 표시 ( |
세션이 수십 개일 때 핵심 작업(배포, 데이터 변환 등)만 위에 고정해 두면 전환 속도가 빨라집니다.
5.5 📁 File Browser (파일 시스템)
(스크린샷: 사용자 홈 폴더·계정명은 가림 — 직접 삽입)
역할: 에이전트 작업 디렉터리를 앱 안에서 트리로 탐색·미리보기합니다.
UI 요소 | 설명 |
|---|---|
상단 아이콘 | 뷰 전환, 폴더 열기, 새로고침 |
루트 | 설정된 홈·프로젝트 폴더 |
트리 |
|
스크롤 | 깊은 프로젝트 구조 탐색 |
활용
에이전트가 읽기·쓰기·수정하는 파일을 실시간으로 따라가기
프로젝트마다
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 뷰
(세션 제목·날짜는 가린 캡처 권장)
요소 | 설명 |
|---|---|
검색 | Search sessions, views, and actions |
뷰 탭 | Sessions / System / Usage |
세션 목록 | 최신순, 제목 + 생성/수정 일시 |
행 액션 | 🔖 북마크(고정), ⬇️보내기, 🗑️ 삭제 |
💡 사이드바 세션 목록 = 빠른 전환. Command Center Sessions = 검색·정리·보내기·삭제에 적합.
System 뷰
영역 | 설명 |
|---|---|
상태 카드 | 게이트웨이 동작, Hermes 버전, 활성 세션 수 |
버튼 | Restart messaging, Update Hermes |
Recent logs | image_gen, video_gen, web, browser 등 플러그인·프로바이더 등록 로그 — 부팅·게이트웨이 진단용 |
Usage 뷰
(개인 세션 수·토큰 수·비용·TOP 모델 목록은 캡처에서 제외)
영역 | 설명 |
|---|---|
기간 | 7d / 30d / 90d |
요약 지표 | SESSIONS, API CALLS, TOKENS IN/OUT, EST. COST |
Daily tokens | 일별 막대 그래프 |
TOP MODELS / TOP SKILLS | 사용 비중 참고 |
💡 로컬 모델은 비용이 0에 가깝습니다. Usage는 순수 사용량·스킬 정리 참고용으로 유용합니다.
5.8 🔌 Gateway 상태 (하단 상태 바)
열기: 하단 Gateway ready 클릭
영역 | 설명 |
|---|---|
헤더 | Gateway · Inference ready |
Connection | 연결 상태 |
RECENT ACTIVITY | 웹서버 마운트, WebSocket 피어 접속 등 |
MESSAGING PLATFORMS | 연결된 채널(Telegram 등) |
진단: 봇 무응답·추론 불가 시 — 게이트웨이 vs 모델 vs 메신저 중 어디가 끊겼는지 1차 확인.
5.9 🌿 Agent Spawn Tree (Agents)
열할: 하단 Agents 클릭
항목 | 설명 |
|---|---|
역할 | 현재 턴의 서브에이전트 활동 실시간 표시 |
비어 있을 때 | No live subagents |
서브에이전트 | 독립 대화·터미널·Python RPC로 격리 실행 — 병렬·분할 작업 추적 |
5.10 ⏰ Cron (예약 작업)
역할: 자연어 또는 cron 문법으로 예약 프롬프트 실행. 결과를 데스크탑·Telegram·Discord·Slack·Email 등으로 전달.
UI | 설명 |
|---|---|
Search cron jobs | 작업 검색 |
+ New cron | 새 작업 |
ACTIVE 카운트 | 예: 1/1 ACTIVE |
New cron job 모달
필드 | 설명 |
|---|---|
Name | 작업 이름 |
Prompt | 에이전트에 보낼 지시 |
Frequency | cron 또는 자연어 ( |
Deliver to | This desktop, Telegram, Discord, Slack, Email |
미리보기 | 예: Every day at 오전 9:00 |
목록 행 액션 (좌→우)
순서 | 버튼 | 기능 |
|---|---|---|
1 | ⏸ Pause | 자동 실행 일시 중지 (작업 유지) |
2 | ⚡ Trigger now | 예약과 무관하게 즉시 1회 실행 (테스트용) |
3 | ✏️ Edit | 이름·프롬프트·주기·전달 대상 수정 |
4 | 🗑️ Delete | 작업 삭제 |
활용 예
매일 아침 요약 → 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 창
영역 | 설명 |
|---|---|
좌측 | 프로필 목록, + New profile |
우측 | MODEL / SKILLS 카드, SOUL.md 편집기, Save |
SOUL.md란?
프로필별 시스템 프롬프트·페르소나
매 메시지마다 다시 로드 (앱 재시작 불필요)
비우면 기본 성격
활용 예시
프로필 | SOUL.md 요지 | 묶기 좋은 것 |
|---|---|---|
기본 | 한국어, 간결, 확인 후 실행 | General 스킬 |
업무·평가 | 표·근거 중심, 추측 최소화 | Research, Note-Taking |
개발 | 파일 경로 명시, diff 위주 | Software-Development, Github |
글쓰기 | 독자 비개발자, 코드 최소 | Creative |
Copy setup — 다른 프로필 설정을 복제해 시작할 때 유용합니다.
5.13 ⚙️ Settings (톱니바퀴) — 전체 설정
설정 창 좌측 패널 기준 요약입니다.
패널 | 주요 내용 |
|---|---|
Model | Main model + Auxiliary 보조 모델 |
Chat | 채팅 동작·표시 |
Appearance | Color Mode, Tool Call Display, Theme |
Workspace | 작업 공간 |
Safety | 안전·승인 관련 |
Memory & Context | 메모리·컨텍스트 |
Voice | 음성 입출력 (플랫폼별 마이크 권한) |
Advanced | 한도, Max Agent Steps 등 |
Gateway | Local / Remote gateway (URL + Session token) |
API Keys | §5.11 참고 |
MCP | MCP 서버 JSON 등록 |
Archived Chats | 보관 대화 |
About | 버전 정보 |
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
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 무응답
하단 Gateway 팝업 → Connection·MESSAGING PLATFORMS
Messaging → Telegram Enabled·토큰·Allowed user IDs
hermes logs gui -f에서 게이트웨이 오류 확인
Remote gateway — 연결은 되는데 채팅만 안 됨
백엔드를
hermes dashboard --tui로 실행했는지 확인 (--tui없으면 status는 OK인데 WebSocket 거부)
7. Notion 공개 페이지 · 외부 공유
7.1 최종 공개 링크 (공유용)
용도 | 링크 |
|---|---|
한국어 가이드 | |
복사·붙여넣기 |
|
GPTERS·Telegram·블로그 등에 올릴 때는 위 링크 한 줄이면 됩니다.
7.2 Notion에서 공개 범위 확인
가이드 페이지 열기
우측 상단 Share → Publish 탭
Publish to web 켜기
Copy web link 로 복사 (로그인 없이 보기용 URL —
notion.site도메인일 수 있음)권장: Allow editing 끄기 · 필요 시 검색 색인만 조정
app.notion.com/p/...링크는 워크스페이스·게시 설정에 따라 동작이 다를 수 있습니다. 외부인이 “권한 없음”이면 Publish to web 과 Copy web link URL을 함께 안내하세요.
7.3 로컬 md로 Notion 수정·동기화 (선택)
가이드를 텍스트로 다시 올리거나 백업할 때:
방법 1 — Import (이미지 포함 시)
Notion → Import → Markdown & CSV
HERMES_DESKTOP_GUIDE_2026-06-04.md+images/를 zip으로 업로드
방법 2 — 붙여넣기
md 본문 복사 → 기존 Notion 페이지에 붙여넣기
스크린샷·
images/…자리 보완
7.4 공개 전 개인정보 체크리스트
캡처 유형 | 가릴 것 |
|---|---|
메인·세션 목록 | 세션 제목, 날짜 |
File Browser·Shell |
|
Messaging | Bot token, Allowed user IDs |
API Keys | 키·configured 개수 |
Artifacts | 전체 경로, GitHub 계정·저장소 |
Command Center Sessions/Usage | 제목·토큰·비용·TOP 목록 |
Manage profiles | 설치 경로, 구체 모델명 |
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
로그인하고 댓글을 남겨 주세요



노션 자료 정리까지!! 수고 많으셨습니다!!