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

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

방법 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 플래그

플래그

설명

--cwd PATH

채팅 세션의 초기 작업 디렉터리 (HERMES_DESKTOP_CWD)

--skip-build

이미 빌드된 앱만 실행

--hermes-root PATH

Hermes 소스 루트 지정

업데이트

hermes update

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

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

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

백엔드

설정 예시

llama.cpp

--ctx-size 65536

Ollama

-c 65536

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

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 /newbot 으로 발급 (필수)

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 (개수 표시)

카운트

예: 1-41 of 41 items

테이블 컬럼

TITLE/NAME, LOCATION(경로·URL), SESSION(생성 세션·일시)

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

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

5.4 📌 PINNED — 세션 고정

항목

설명

역할

중요한 대화를 SESSIONS 목록 위에 항상 노출

고정

세션에서 Shift + 클릭

순서

드래그로 재정렬

비어 있을 때

안내 문구만 표시 (Shift-click a session to pin 등)

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

5.5 📁 File Browser (파일 시스템)

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

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

UI 요소

설명

상단 아이콘

뷰 전환, 폴더 열기, 새로고침

루트

설정된 홈·프로젝트 폴더

트리

> 로 폴더 펼침, 폴더 vs 파일 아이콘 구분

스크롤

깊은 프로젝트 구조 탐색

활용

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

• 프로젝트마다 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 또는 자연어 (every 15 minutes)

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

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

부팅·백엔드 실패

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.1 최종 공개 링크 (공유용)

용도

링크

한국어 가이드

Hermes Desktop Guide (KO)

복사·붙여넣기

https://app.notion.com/p/Hermes-desktop-guide-ko-374963bb1474804cafaac003c4bce49d

Clauders·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 공개 전 개인정보 체크리스트

캡처 유형

가릴 것

메인·세션 목록

세션 제목, 날짜

File Browser·Shell

C:\Users\..., 사용자명

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. 참고 링크

링크

설명

Hermes Desktop 한국어 가이드 (Notion)

공개·공유용 최종본

Hermes Agent Desktop 문서

설치·플래그·원격·트러블슈팅 (영문 공식)

Hermes Agent GitHub

소스·이슈

agentskills.io

스킬 표준

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