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

- 작성자: [주말의 기린](https://community.clauders.ai/member/imported-member-mIawQvprEj)
- 공간: [에이전트 / 노코드 자동화](https://community.clauders.ai/automation)
- 게시: 2026-06-04
- 연재: [비용 효율적인 Hermes 운영](https://community.clauders.ai/series/cost-efficient-hermes-agent) 1/3편
- 태그: #가성비Hermes
- 주소: https://community.clauders.ai/automation/post/hermes-desktop-%ED%97%A4%EB%A5%B4%EB%A9%94%EC%8A%A4-%EB%8D%B0%EC%8A%A4%ED%81%AC%ED%83%91-%ED%95%9C%EA%B5%AD%EC%96%B4-%EA%B0%80%EC%9D%B4%EB%93%9C-e0e5c157-5980-8fc8-a84b-74e581a5e1ac

---

> **작성일:** 2026-06-04  
> **기준:** Nous Research Hermes Desktop 공개 프리뷰 (2026-06-03), Hermes Agent v0.15.2  
> **공식 문서:** [Desktop App | Hermes Agent](https://hermes-agent.nousresearch.com/docs/user-guide/desktop)

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

1. [Hermes 공식 사이트](https://hermes-agent.nousresearch.com/)에서 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](https://hermes-agent.nousresearch.com/docs/user-guide/desktop#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)

**복사·붙여넣기**

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

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

### **7.2 Notion에서 공개 범위 확인**

1. [가이드 페이지](https://app.notion.com/p/Hermes-desktop-guide-ko-374963bb1474804cafaac003c4bce49d) 열기
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 페이지](https://app.notion.com/p/Hermes-desktop-guide-ko-374963bb1474804cafaac003c4bce49d)에 붙여넣기
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)**](https://app.notion.com/p/Hermes-desktop-guide-ko-374963bb1474804cafaac003c4bce49d)

**공개·공유용 최종본**

[Hermes Agent Desktop 문서](https://hermes-agent.nousresearch.com/docs/user-guide/desktop)

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

[Hermes Agent GitHub](https://github.com/NousResearch/hermes-agent)

소스·이슈

[agentskills.io](https://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](https://app.notion.com/p/Hermes-desktop-guide-ko-374963bb1474804cafaac003c4bce49d)