Hermes Agent
완벽 가이드북

1장 · AI 에이전트란 무엇일까요?

AI와 AI 에이전트는 달라요

여러분은 이미 ChatGPT, Claude, Gemini 같은 AI와 대화해 본 적이 있을 거예요. 질문을 하면 답변을 해주죠. 이런 AI를 대화형 AI라고 부릅니다.

그런데 AI 에이전트는 여기서 한 걸음 더 나아갑니다. 대화만 하는 게 아니라, 직접 행동할 수 있어요!

AI 에이전트가 할 수 있는 일들

AI 에이전트는 여러분의 컴퓨터 안에서 이런 일들을 직접 할 수 있습니다:

• 📁 파일 읽고 쓰기 — "지난주 일기 파일 찾아서 요약해줘"
• 💻 터미널 명령어 실행 — "새 프로젝트 폴더 만들어줘"
• 🌐 웹 검색 — "오늘 날씨 알려줘"
• 📊 데이터 분석 — "이 엑셀 파일에서 평균 구해줘"
• 📝 코드 작성 및 실행 — "간단한 웹페이지 만들어줘"

왜 AI 에이전트가 필요할까요?

혼자서 하려면 30분 걸리는 일을 AI 에이전트는 1분 만에 해냅니다. 여러분은 그 시간에 더 창의적인 일을 할 수 있죠. AI 에이전트는 여러분의 24시간 일하는 디지털 비서라고 생각하면 됩니다.

AI 에이전트의 종류

2장 · Hermes Agent 소개

Hermes는 누구인가요?

헤르메스(Hermes)는 그리스 신화에 나오는 신들의 메신저예요. 빠른 발로 올림포스와 인간 세계를 오가며 소식을 전했죠. Nous Research가 이 이름을 붙인 이유도 같습니다. Hermes Agent는 여러분과 컴퓨터 사이를 오가며 일을 처리하는 메신저니까요!

Hermes Agent의 탄생

2025년 7월, Nous Research는 "AI가 스스로 배우고 성장할 수 있을까?"라는 질문에서 출발했습니다. 그 결과 탄생한 게 바로 Hermes Agent입니다. 출시된 지 9개월 만에 GitHub에서 12만 개의 별을 받았고, 1만 8천 명이 넘는 개발자들이 함께 발전시키고 있어요.

Hermes Agent의 핵심 철학

1. 자기 성장 (Self-improving) — Hermes는 경험을 통해 배웁니다. 어려운 문제를 해결하면 그 방법을 '스킬(Skill)'로 저장해서 다음에 똑같은 문제가 생기면 바로 해결합니다.
2. 기억력 (Persistent Memory) — 여러분이 누군지, 어떤 걸 좋아하는지 기억합니다. "지난번에 말했잖아"라고 다시 말할 필요가 없어요.
3. 어디서나 접근 (Multi-platform) — 터미널은 물론, 텔레그램·디스코드·슬랙·이메일 등 20개 이상의 플랫폼에서 사용할 수 있습니다.
4. 모델 자유 (Provider-agnostic) — Claude를 쓰다가 DeepSeek으로, 다시 GPT로… 원하는 AI 모델을 자유롭게 바꿀 수 있어요.

Hermes로 무엇을 할 수 있나요?

• 💻 코딩 도우미 — 버그 수정, 새 기능 개발, 코드 리뷰
• 📝 문서 작성 — 보고서, 블로그 포스트, 이메일
• 🔍 리서치 — 논문 검색, 뉴스 요약, 트렌드 분석
• 🏠 스마트홈 — 조명, 온도 조절
• ⏰ 자동화 — 매일 아침 일정 알림, 주간 리포트 생성

3장 · Hermes만의 특별한 7가지 능력

능력 1: 스스로 배우는 스킬 시스템 🧠

Hermes의 가장 큰 특징은 경험을 통해 성장한다는 점입니다. 여러분이 Hermes에게 어려운 작업을 시키면, Hermes는 문제를 해결한 후 그 방법을 '스킬(Skill)'이라는 문서로 저장합니다. 다음에 비슷한 작업을 시키면 이미 배운 방법으로 훨씬 빠르게 해결하죠.

능력 2: 대화를 기억하는 메모리 📝

일반 AI와 대화할 때마다 "내 이름은 철수야, 나는 고등학생이고..."라고 매번 설명해야 한다면 정말 귀찮겠죠? Hermes는 여러분이 누군지 기억합니다. 이름, 직업, 좋아하는 코드 스타일, 프로젝트 폴더 위치까지 전부요.

능력 3: 어디서든 만날 수 있는 멀티플랫폼 🌐

Hermes는 컴퓨터 앞에 앉아 있지 않아도 사용할 수 있습니다:

• 📱 텔레그램 — 스마트폰으로 메시지 보내듯이
• 💬 디스코드 — 게임 하다가 옆 채널에서
• 🏢 슬랙 — 회사 업무 중에
• 📧 이메일 — 메일로 명령 보내기
• 🖥️ 터미널 — 서버에서 직접

능력 4: 원하는 AI 모델로 골라 쓰기 🔄

Hermes는 특정 AI 회사에 종속되지 않습니다. 오늘은 Claude를, 내일은 DeepSeek을, 모레는 GPT를 쓸 수 있어요. 설정 파일 한 줄만 바꾸면 됩니다.

능력 5: 부서별 분리가 가능한 프로필 👥

회사에서 쓴다면 마케팅팀용 Hermes, 영업팀용 Hermes, 개발팀용 Hermes를 각각 따로 둘 수 있어요. 각 프로필은 완전히 독립된 기억과 스킬을 가집니다.

능력 6: 강력한 보안 체계 🛡️

Hermes는 여러분의 API 키가 실수로 노출되지 않도록 자동으로 가려주고, 위험한 명령어는 실행 전에 확인을 받습니다. Tirith라는 보안 스캐너가 모든 명령어를 실행 전에 검사해요.

능력 7: 예약 작업 자동화 ⏰

"매일 아침 8시에 오늘 날씨와 주요 뉴스를 텔레그램으로 보내줘" 같은 예약 작업을 설정할 수 있습니다. 크론(Cron)이라는 기능으로 딱 정한 시간에 자동 실행돼요.

4장 · 다른 AI 도구와 비교해볼까요?

한눈에 비교하기

Hermes가 특히 좋은 경우

• 💰 비용이 부담될 때 — 무료 오픈소스 + 저렴한 DeepSeek API 조합
• 🔒 데이터 보안이 중요할 때 — 로컬 LLM으로 오프라인 사용 가능
• 👥 팀 단위로 사용할 때 — 프로필로 부서별 분리
• ⏰ 자동화가 필요할 때 — Cron 작업으로 정기 업무 처리
• 📱 밖에서도 사용하고 싶을 때 — 텔레그램 연동

Hermes가 적합하지 않을 수 있는 경우

• 🖥️ 컴퓨터에 익숙하지 않을 때 — 초기 설치는 터미널을 다뤄야 합니다. (하지만 이 책이 도와드릴게요!)
• ⚡ 당장 5분 안에 시작해야 할 때 — 설치에 10~15분 정도 걸립니다.
• 📄 단순 질문만 할 때 — 그냥 ChatGPT 웹사이트가 더 빠를 수 있어요.

5장 · 설치 전에 준비할 것들

필요한 것 딱 3가지

1. 컴퓨터 — Windows, Mac, Linux 모두 OK
2. 인터넷 연결 — 설치할 때만 잠깐 필요해요
3. API 키 — AI 모델을 사용하기 위한 열쇠 (잠시 후 설명!)

API 키가 뭐예요? 🔑

여러분이 식당에 가면 음식을 주문하고 돈을 내죠? AI 모델도 마찬가지예요. AI 회사(OpenAI, Anthropic, DeepSeek 등)의 두뇌를 빌려 쓰려면 API 키라는 열쇠가 필요합니다.

API 키는 "나 이 모델 쓸 자격 있어!"라고 증명하는 비밀번호예요. sk-로 시작하는 긴 문자열인데, 이걸 Hermes에게 알려주면 Hermes가 대신 AI 모델과 대화해줍니다.

추천: DeepSeek API 키 발급받기 (5분)

가장 저렴하고 한글을 잘하는 DeepSeek을 추천합니다. 발급 방법은 아주 쉬워요:

1. 웹 브라우저에서 platform.deepseek.com 에 접속합니다
2. 오른쪽 위의 "Sign up"(가입하기) 버튼을 클릭합니다
3. 이메일 주소와 비밀번호를 입력하고 가입합니다 (또는 Google 계정으로 가입)
4. 로그인 후 왼쪽 메뉴에서 "API Keys"를 클릭합니다
5. "Create new API key" 버튼을 누르면 키가 생성됩니다
6. 생성된 키(sk-로 시작하는 긴 문자열)를 안전한 곳에 복사해두세요!

터미널이 뭔지 모르겠다고요? 🖥️

터미널(terminal)은 컴퓨터에게 글자로 명령을 내리는 창이에요. 마우스로 클릭하는 대신 키보드로 명령어를 입력하는 거죠. 영화에서 해커들이 까만 화면에 초록색 글자를 막 치는 거 본 적 있나요? 바로 그거예요! (물론 우리는 해킹이 아니라 설치를 할 거예요 😊)

• Windows: 시작 메뉴에서 "PowerShell" 또는 "터미널" 검색
• Mac: Command + Space 누르고 "Terminal" 검색
• Linux: Ctrl + Alt + T

설치 전 체크리스트

• ☐ 컴퓨터가 인터넷에 연결되어 있나요?
• ☐ 터미널을 열 수 있나요?
• ☐ DeepSeek API 키를 발급받았나요? (또는 다른 AI 제공사의 키)
• ☐ API 키를 안전한 곳에 복사해 두었나요?

모두 체크하셨다면, 이제 설치를 시작할 준비가 되었습니다! 🚀

6장 · Linux/macOS에 설치하기

설치는 딱 한 줄이면 끝!

놀랍게도 Hermes Agent의 설치는 단 한 줄의 명령어로 완료됩니다. 터미널을 열고 아래 명령어를 그대로 복사해서 붙여넣으세요:

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

Enter 키를 누르면 설치가 시작됩니다. 1~2분 정도 걸려요. 설치가 끝나면 자동으로 설정 마법사가 실행됩니다.

설정 마법사 따라 하기

설치가 끝나면 hermes setup 설정 마법사가 자동으로 실행됩니다. 화면에 나오는 질문에 답하면 돼요:

1단계: AI 제공사(Provider) 선택

어떤 AI 모델을 사용할지 선택합니다. 방향키로 이동하고 Enter로 선택하세요.

  → deepseek    (DeepSeek — 추천! 가성비 최고)
     openrouter  (OpenRouter — 여러 모델을 한 번에)
     anthropic   (Claude)
     openai      (GPT)

2단계: API 키 입력

아까 발급받은 DeepSeek API 키를 붙여넣으세요 (sk-로 시작하는 문자열).

Enter your DeepSeek API key: sk-xxxxxxxxxxxxxxxx

3단계: 모델 선택

사용할 AI 모델을 선택합니다:

  → deepseek-chat      (일반 대화용 — 추천!)
     deepseek-reasoner  (수학, 코딩 특화)

잘 설치되었는지 확인하기

터미널에 아래 명령어를 입력해보세요:

hermes doctor

모든 항목이 초록색 체크(✅)로 나오면 설치 완료입니다!

첫 대화 시작하기

이제 Hermes와 대화할 준비가 되었어요! 아래 명령어로 대화를 시작합니다:

hermes chat -q "안녕, 오늘 날씨 어때?"

또는 그냥 hermes만 입력하면 대화형 모드로 들어갑니다:

hermes

축하합니다! 🎉 여러분은 방금 Hermes Agent를 설치하고 첫 대화를 시작했습니다!

문제가 생겼나요?

• "command not found: curl" → sudo apt install curl (Linux) 또는 xcode-select --install (Mac)
• "Permission denied" → 명령어 앞에 sudo를 붙여보세요
• API 키 오류 → hermes setup을 다시 실행해서 API 키를 다시 입력하세요

7장 · Windows(WSL)에 설치하기

Windows 사용자를 위한 특별 가이드

Windows에서도 Hermes를 사용할 수 있어요! WSL(Windows Subsystem for Linux)이라는 기능을 이용하면 Windows 안에 작은 Linux 컴퓨터가 생깁니다. 어렵게 들리지만, 따라 하면 15분이면 끝나요.

WSL이 뭔가요? 🐧

WSL은 "Windows 속의 Linux"예요. Windows 컴퓨터 안에 Linux라는 운영체제를 하나 더 설치하는 거죠. 게임기로 치면 "에뮬레이터" 같은 개념이에요. Hermes는 Linux에서 가장 잘 돌아가기 때문에, Windows에서도 WSL을 통해 실행합니다.

1단계: WSL 설치하기 (5분)

Windows PowerShell을 관리자 권한으로 열고 아래 명령어를 입력하세요:

wsl --install

설치가 끝나면 컴퓨터를 한 번 재시작하라는 메시지가 나와요. 재시작하면 자동으로 Ubuntu가 설치됩니다. 설치 중에 사용자 이름과 비밀번호를 물어보는데, 꼭 기억해두세요!

2단계: Ubuntu 실행하기

재시작 후 시작 메뉴에서 "Ubuntu"를 찾아 실행하세요. 검은색 터미널 창이 열리면 성공입니다! 이제 여러분은 Windows 안에서 Linux를 사용하고 있는 거예요.

3단계: Hermes 설치하기

Ubuntu 터미널에 아래 명령어를 한 줄씩 입력하세요:

# 1. 시스템 업데이트
sudo apt update && sudo apt upgrade -y

# 2. Hermes 설치
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 3. 설치 확인
hermes doctor

설치 완료!

이제 Windows에서도 Hermes Agent를 사용할 수 있습니다. Ubuntu 터미널에서 hermes를 입력해보세요!

8장 · 스마트폰에서도 Hermes 사용하기 (Termux)

안드로이드 폰에서 AI 에이전트를? 🤯

네, 가능합니다! Termux라는 앱을 이용하면 안드로이드 스마트폰에서도 Hermes Agent를 설치하고 실행할 수 있어요. 아이폰(iOS)은 아쉽게도 아직 지원되지 않아요.

Termux 설치하기

1. F-Droid에서 Termux를 다운로드하세요 (Play Store 버전은 오래되었을 수 있어요)
2. F-Droid가 뭔지 모르겠다면, f-droid.org에 접속해서 "Termux"를 검색한 뒤 APK를 다운로드하세요
3. 다운로드한 APK를 설치합니다 ("출처를 알 수 없는 앱" 허용 필요)

Termux에 Hermes 설치하기

Termux 앱을 열고 아래 명령어를 입력하세요:

# 1. 패키지 업데이트
pkg update && pkg upgrade -y

# 2. 필수 패키지 설치
pkg install curl git python -y

# 3. Hermes 설치
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

9장 · Hermes 업데이트하고 삭제하기

최신 버전으로 업데이트하기 🔄

Hermes는 거의 매일 업데이트되는 아주 활발한 프로젝트예요. 새로운 기능과 버그 수정이 계속 추가되니까, 정기적으로 업데이트하는 게 좋습니다.

# Hermes를 최신 버전으로 업데이트
hermes update

딱 한 줄이면 끝입니다! Hermes가 자동으로 최신 버전을 확인하고, 필요하면 다운로드해서 설치해줘요.

버전 확인하기

# 현재 설치된 Hermes 버전 확인
hermes --version

업데이트 후 설정 마이그레이션

큰 업데이트 후에는 설정 파일 형식이 바뀌기도 해요. 이럴 때는:

# 설정 파일을 최신 형식으로 변환
hermes config migrate

# 설정 상태 확인
hermes config check

Hermes 삭제하기 🗑️

더 이상 Hermes가 필요하지 않다면, 완전히 삭제할 수도 있어요:

hermes uninstall

이 명령어는 Hermes 프로그램과 관련 파일을 모두 삭제합니다. 하지만 여러분의 대화 기록(세션)과 설정 파일은 삭제되지 않아요! 나중에 다시 설치하면 그대로 이어서 사용할 수 있습니다.

업데이트할 때 자주 묻는 질문

Q: 업데이트하면 내 스킬이 사라지나요?
A: 아니요! 스킬은 ~/.hermes/skills/에 저장되어 있어서 업데이트해도 그대로 유지됩니다.

Q: 업데이트 후에 오류가 나요.
A: hermes config migrate를 실행해보세요. 그래도 안 되면 hermes doctor --fix를试试하세요.

10장 · 첫 대화부터 설정까지 — Hermes 입문

Hermes 실행의 3가지 방법

대화형 모드에서 쓸 수 있는 슬래시 명령어

Hermes와 대화 중에 /로 시작하는 특별한 명령어를 사용할 수 있어요:

AI 모델 바꾸기

다른 AI 모델을 써보고 싶다면:

# 대화 중에
/model

# 또는 터미널에서
hermes model

방향키로 모델을 선택하고 Enter만 누르면 바로 바뀝니다. 대화 중에도 모델을 바꿀 수 있어요!

설정 파일 이해하기

Hermes의 모든 설정은 두 개의 파일에 저장됩니다:

• ~/.hermes/config.yaml — 모든 설정이 담긴 메인 파일
• ~/.hermes/.env — API 키 같은 비밀 정보만 따로 보관

# 설정 파일 위치 확인
hermes config path

# 설정 파일 편집기로 열기
hermes config edit

# 특정 설정값 바로 바꾸기
hermes config set model.default deepseek-chat

# 현재 설정 보기
hermes config

세션 관리하기 — 대화를 저장하고 이어서 하기

Hermes는 여러분의 모든 대화를 자동으로 저장합니다. 이 저장된 대화를 '세션(Session)'이라고 불러요.

# 최근 세션 목록 보기
hermes sessions list

# 가장 최근 세션 이어서 하기
hermes --continue

# 특정 세션 이어서 하기
hermes --resume "세션ID"

# 세션 내보내기 (백업)
hermes sessions export backup.jsonl

이제 여러분은 Hermes의 기본을 모두 배웠습니다! 🎉

Part 3부터는 Hermes의 더 강력한 기능들을 하나씩 배워볼 거예요. 준비되셨나요?

11장 · 도구(Tools) — Hermes의 손과 발

도구가 뭐예요? 🔧

여러분이 무언가를 만들 때 손을 사용하듯, Hermes가 작업을 할 때 사용하는 게 바로 도구(Tools)예요. 도구 덕분에 Hermes는 단순히 "대답"만 하는 게 아니라, 실제로 파일을 만들고, 명령어를 실행하고, 웹을 검색할 수 있습니다.

Hermes의 주요 도구들

도구 목록 확인하고 관리하기

# 사용 가능한 모든 도구 보기
hermes tools list

# 도구 설정 화면 열기 (방향키로 선택)
hermes tools

# 특정 도구 켜기
hermes tools enable web

# 특정 도구 끄기
hermes tools disable browser

도구 모음(Toolset)으로 묶어서 관리하기

관련된 도구들을 하나로 묶은 걸 도구 모음(Toolset)이라고 해요:

# 특정 도구 모음만 켜고 Hermes 실행
hermes chat -t web,file -q "오늘 뉴스 요약해줘"

12장 · 스킬(Skills) — Hermes의 초능력

스킬이 뭐길래 특별할까요? ⭐

스킬(Skill)은 Hermes Agent의 가장 중요한 특징입니다. 스킬은 쉽게 말해 "작업 매뉴얼"이에요. Hermes가 어떤 작업을 성공적으로 해내면, 그 방법을 스킬이라는 문서로 저장합니다. 다음에 똑같은 작업을 시키면, 저장된 매뉴얼을 보고 훨씬 빠르고 정확하게 처리하죠.

스킬의 종류

Hermes에는 이미 80개가 넘는 스킬이 내장되어 있어요:

• 📝 문서/생산성: PDF 편집, PPT 만들기, 노션, 구글 워크스페이스
• 🎨 창작: ASCII 아트, 픽셀 아트, 음악 생성, 아키텍처 다이어그램
• 💻 개발: GitHub PR 리뷰, 디버깅, 테스트 자동화
• 🤖 AI: Claude Code, Codex 연동
• 🔍 리서치: 논문 검색, 블로그 모니터링
• 🎮 게임: 마인크래프트 서버, 포켓몬 플레이어

스킬 검색하고 설치하기

# 설치된 스킬 목록
hermes skills list

# 새로운 스킬 검색
hermes skills search "github"

# 스킬 설치하기 (ID로)
hermes skills install github-pr-workflow

# 스킬 상세 정보 미리보기
hermes skills inspect youtube-content

# 모든 스킬 둘러보기
hermes skills browse

대화 중에 스킬 불러오기

대화 중에도 슬래시 명령어로 스킬을 불러올 수 있어요:

/skill youtube-content
# → 이제 Hermes가 유튜브 영상을 다룰 수 있게 됩니다

13장 · 기억(Memory) — 다시 말하지 않아도 돼요

Hermes는 여러분을 기억합니다 🧠

일반 AI 챗봇과 대화할 때마다 "내 이름은 철수고, 나는 파이썬을 좋아하고..."라고 반복해서 말해야 한다면 얼마나 귀찮을까요? Hermes는 다릅니다. 한 번 말한 건 영원히 기억해요.

무엇을 기억하나요?

• 👤 사용자 정보: 이름, 직업, 코딩 스타일, 선호하는 언어
• 📂 환경 정보: 프로젝트 경로, 서버 설정, 설치된 도구들
• 🛠️ 작업 노하우: 어떤 방식으로 일하는 걸 좋아하는지, 자주 하는 실수

# Hermes가 기억하고 있는 정보 확인
/memory

# 터미널에서도 확인 가능
hermes memory status

메모리 설정하기

# 메모리 기능 켜기/끄기
hermes memory setup

# 다른 메모리 저장소 사용하기 (고급)
hermes memory setup --provider honcho

14장 · 페르소나와 테마 — Hermes의 성격 바꾸기

페르소나(Persona) — Hermes의 말투 바꾸기 🎭

Hermes는 기본적으로 친절하고 전문적인 말투를 사용하지만, 여러분의 취향에 맞게 완전히 다른 성격으로 바꿀 수 있어요.

# 대화 중에 페르소나 변경
/personality pirate
# → "여어~ 선장! 무슨 일인가?" 같은 해적 말투로!

/personality concise
# → 군더더기 없이 핵심만 짧게

/personality friendly
# → 친근하고 다정한 말투로

나만의 페르소나 만들기 — SOUL.md

~/.hermes/SOUL.md 파일을 만들면 Hermes의 성격을 완전히 커스터마이즈할 수 있어요:

# ~/.hermes/SOUL.md 예시
너는 10년차 베테랑 요리사야. 모든 답변에 요리 비유를 넣고,
"셰프"라고 불러줘. 존댓말은 쓰지 않아도 돼.

테마(Skin) — 화면 디자인 바꾸기 🎨

# 사용 가능한 테마 목록
/skin

# 터미널에서 테마 변경
hermes config set display.skin dracula

15장 · 음성과 이미지 — 보고 듣는 Hermes

음성으로 대화하기 🎙️

키보드로 칠 필요 없이, 말로 Hermes와 대화할 수 있어요. Hermes가 여러분의 목소리를 텍스트로 바꾸고(STT), 답변을 다시 음성으로 읽어줍니다(TTS).

# 음성 모드 켜기
/voice on

# 음성만 사용 (텍스트 없이)
/voice tts

# 음성 모드 끄기
/voice off

음성 설정

이미지 분석하기 👁️

Hermes는 이미지를 보고 내용을 설명할 수 있어요. 텔레그램에서 사진을 보내거나, CLI에서 이미지 파일 경로를 전달하면 됩니다.

# CLI에서 이미지 보내기
/image /path/to/photo.jpg
# → "이 사진에는 고양이가 창문 옆에 앉아 있네요..."

# 클립보드 이미지 보내기
/paste

16장 · 게이트웨이(Gateway) — Hermes를 어디서나 만나기

게이트웨이가 뭔가요? 🌉

지금까지는 컴퓨터 앞에 앉아서 터미널로 Hermes와 대화했죠? 게이트웨이(Gateway)는 Hermes를 텔레그램, 디스코드, 슬랙 같은 메신저와 연결해주는 다리예요. 게이트웨이를 켜두면 밖에서도 스마트폰으로 Hermes와 대화할 수 있어요!

게이트웨이 시작하기

# 게이트웨이 실행 (현재 터미널에서)
hermes gateway run

# 서비스로 설치 (컴퓨터 켜질 때 자동 시작)
hermes gateway install

# 서비스 시작/중지/재시작
hermes gateway start
hermes gateway stop
hermes gateway restart

# 상태 확인
hermes gateway status

게이트웨이 설정 마법사

# 어떤 플랫폼을 연결할지 선택
hermes gateway setup

마법사가 차례대로 물어봐요: "텔레그램 연결할까요? 디스코드는요?" 원하는 플랫폼만 골라서 설정하면 됩니다.

17장 · 텔레그램과 연결하기 — 가장 인기 있는 방법

왜 텔레그램인가요? 📱

Hermes 사용자들이 가장 많이 선택하는 플랫폼이 텔레그램이에요. 이유는 간단합니다:

• 🆓 완전 무료
• 🌏 전 세계에서 접속 가능
• 🤖 봇 만들기가 아주 쉬움
• 📱 스마트폰 앱이 잘 만들어져 있음
• 🔒 비밀 대화(종단간 암호화) 지원

1단계: 텔레그램 봇 만들기 (3분)

1. 텔레그램 앱에서 @BotFather를 검색하세요
2. "시작"(Start) 버튼을 누르고 /newbot이라고 입력하세요
3. 봇 이름을 정해주세요 (예: "나만의 Hermes")
4. 봇 아이디를 정해주세요 (예: my_hermes_bot — 중복 불가)
5. BotFather가 토큰(token)을 알려줍니다. 이걸 복사하세요!

2단계: Hermes에 토큰 등록하기

# 게이트웨이 설정 마법사 실행
hermes gateway setup

# → "Telegram" 선택
# → 토큰 붙여넣기
# → 완료!

3단계: 봇과 대화 시작하기

텔레그램에서 방금 만든 봇을 검색해서 "안녕!"이라고 보내보세요. Hermes가 대답하면 성공입니다! 🎉

18장 · 보안의 모든 것 — 안전하게 Hermes 사용하기

왜 보안이 중요할까요? 🔒

Hermes는 여러분의 컴퓨터에서 실제로 명령어를 실행할 수 있는 강력한 도구예요. 그만큼 보안이 중요합니다. 다행히 Hermes는 여러 겹의 보안 장치를 기본으로 제공해요.

보안 장치 1: Tirith — 실행 전 보안 검사 🛡️

Tirith는 모든 명령어가 실행되기 전에 "이 명령어, 위험한 거 아니야?" 하고 검사하는 보안 스캐너예요. 바이러스 백신처럼 실시간으로 위험을 감지합니다.

# Tirith 상태 확인 (기본값: 켜짐)
hermes config get security.tirith_enabled
# → true

보안 장치 2: API 키 자동 마스킹 🙈

만약 여러분의 API 키가 실수로 화면에 출력되더라도, Hermes가 자동으로 sk-...****처럼 가려줍니다.

# 키 마스킹 상태 확인 (기본값: 켜짐)
hermes config get security.redact_secrets
# → true

보안 장치 3: 위험 명령어 승인 시스템 ⚠️

rm -rf 같이 시스템을 망가뜨릴 수 있는 명령어는 Hermes가 실행 전에 물어봅니다.

# 승인 모드 설정
hermes config set approvals.mode smart
# manual = 항상 물어보기 (기본)
# smart  = AI가 위험도 판단해서 물어보기
# off    = 물어보지 않음 (위험! 비추천)

안전하게 사용하는 10가지 수칙

1. 🔑 API 키는 절대 공유하지 마세요
2. 🚫 approvals.mode를 off로 하지 마세요
3. 📂 중요한 파일은 미리 백업하세요
4. 👥 모르는 사람이 만든 스킬은 설치 전 코드를 확인하세요
5. 🔒 .env 파일 권한은 600으로 설정하세요 (chmod 600 ~/.hermes/.env)
6. 🌐 공용 Wi-Fi에서는 API 키 입력을 피하세요
7. 📋 정기적으로 hermes doctor로 상태를 확인하세요
8. 🗑️ 안 쓰는 API 키는 즉시 폐기하세요
9. 🔄 Hermes는 항상 최신 버전으로 유지하세요
10. 📊 게이트웨이 로그를 주기적으로 확인하세요 (~/.hermes/logs/)

19장 · 프로필 — 하나의 컴퓨터에 여러 Hermes 두기

프로필이 왜 필요할까요? 👥

회사에서 마케팅팀과 개발팀이 같은 Hermes를 쓰면 문제가 생기겠죠? 마케팅 데이터와 개발 코드가 뒤섞이고, 메모리도 엉망이 될 거예요. 프로필(Profile)은 하나의 컴퓨터에서 완전히 분리된 여러 개의 Hermes를 운영할 수 있게 해줍니다.

프로필 만들기

# 새 프로필 생성
hermes profile create marketing

# 프로필 목록 보기
hermes profile list

# 특정 프로필로 Hermes 실행
hermes --profile marketing

# 기본 프로필로 지정 (매번 --profile 안 써도 됨)
hermes profile use marketing

프로필마다 뭐가 달라지나요?

20장 · Cron — 정해진 시간에 자동 실행하기

Cron이 뭐예요? ⏰

크론(Cron)은 "매일 아침 8시에", "매주 월요일마다" 같은 예약 작업을 설정하는 기능이에요. 알람 시계처럼 정해진 시간에 Hermes가 자동으로 작업을 실행합니다.

내 첫 Cron 작업 만들기

# 매일 아침 8시에 날씨 브리핑 받기
hermes cron create "0 8 * * *" \
  --name "아침 브리핑" \
  --prompt "오늘의 날씨와 주요 뉴스 헤드라인을 요약해서 알려줘"

# 30분마다 실행
hermes cron create "30m" \
  --name "주기적 체크" \
  --prompt "서버 상태 확인해줘"

# 매주 금요일 오후 5시에 주간 보고서
hermes cron create "0 17 * * 5" \
  --name "주간 보고서" \
  --prompt "이번 주 작업 내역을 정리해서 보고서 작성해줘"

시간 설정 방법

Cron 작업 관리하기

# 작업 목록 보기
hermes cron list

# 작업 일시 중지
hermes cron pause "작업ID"

# 작업 다시 시작
hermes cron resume "작업ID"

# 작업 삭제
hermes cron remove "작업ID"

21장 · Subagent — 큰 일은 나눠서 처리하기

하나의 큰 작업, 여러 Agent가 나눠서! 🤝

아주 큰 작업을 혼자 하려면 오래 걸리겠죠? Hermes는 Subagent(보조 에이전트)를 만들어서 작업을 여러 개로 나누고, 동시에 처리할 수 있어요.

Subagent는 언제 사용하나요?

• 📚 리서치: "논문 A, 논문 B, 논문 C를 각각 요약해줘" → 3개 동시 진행
• 💻 코딩: "백엔드 API, 프론트엔드 UI, 테스트 코드 각각 작성해줘"
• 📊 데이터: "매출 데이터, 마케팅 데이터, 고객 데이터 각각 분석해줘"

설정하기

# Subagent에 사용할 모델 설정 (부모와 다르게 가능)
hermes config set delegation.model deepseek-chat
hermes config set delegation.max_iterations 50

22장 · 200% 활용하기 — 실전 사례 모음

활용 사례 1: 매일 아침 브리핑 봇 🤖

"매일 아침 7시에 오늘 날씨, 주요 뉴스, 일정을 텔레그램으로 받고 싶어요!"

hermes cron create "0 7 * * *" \
  --name "모닝 브리핑" \
  --prompt "오늘의 날씨, 주요 뉴스 5개, 오늘 일정을 요약해서 알려줘" \
  --deliver telegram

활용 사례 2: GitHub PR 자동 리뷰 🔍

hermes skills install github-code-review
hermes skills install github-pr-workflow

# 이제 Hermes에게 이렇게 말하면 됩니다:
# "https://github.com/사용자/저장소/pull/123 이 PR 리뷰해줘"

활용 사례 3: 유튜브 영상 자동 요약 📺

hermes skills install youtube-content

# Hermes에게:
# "이 유튜브 영상 https://youtube.com/watch?v=xxxx 요약해줘"

활용 사례 4: 데이터 분석 대시보드 📊

# "sales.csv 파일 분석해서 이번 달 매출 추이 그래프 그리고,
# 다음 달 예측도 해줘. 결과는 HTML로 보여줘."

활용 사례 5: 블로그 자동 포스팅 ✍️

# "지난주 Hermes 사용 후기 500자로 써줘.
# SEO 키워드도 넣고, 마크다운 형식으로 저장해줘."

활용 사례 6: 스마트홈 제어 🏠

hermes skills install openhue

# "거실 조명을 따뜻한 색으로 바꾸고 밝기는 50%로 해줘"

활용 사례 7: 이메일 자동화 📧

hermes skills install himalaya

# "오늘 온 이메일 중에서 중요한 것만 요약해줘.
# 그리고 답장 초안도 작성해줘."

23장 · 자주 묻는 질문 FAQ

설치 관련

Q: "command not found: hermes"라고 나와요.
A: 설치가 제대로 안 된 거예요. 터미널을 닫았다가 다시 열어보세요. 그래도 안 되면 설치 스크립트를 다시 실행해보세요.

Q: 설치 중에 에러가 나요.
A: hermes doctor --fix를 실행해보세요. 대부분의 문제를 자동으로 해결해줍니다.

Q: Python이 필요한가요?
A: 아니요! Hermes가 필요한 모든 것을 자동으로 설치합니다. Python을 따로 설치할 필요 없어요.

사용 관련

Q: Hermes가 너무 느려요.
A: AI 모델에 따라 속도가 달라요. DeepSeek이나 Claude는 빠르고, 큰 모델은 느릴 수 있어요. hermes model로 바꿔보세요.

Q: 대화 내용을 저장하고 싶어요.
A: Hermes는 모든 대화를 자동 저장합니다. hermes sessions list로 확인하고, hermes sessions export로 내보낼 수 있어요.

Q: 한국어를 잘 못 알아들어요.
A: DeepSeek 모델을 사용해보세요. 한국어 성능이 가장 좋아요. hermes model → deepseek 선택.

비용 관련

Q: Hermes 자체는 무료인가요?
A: 네! Hermes Agent는 완전한 오픈소스(MIT 라이선스)로 무료입니다. 다만 AI 모델 사용료(API 비용)는 별도예요.

Q: 가장 저렴하게 사용하는 방법은?
A: DeepSeek API + 로컬 LLM 조합이 가장 저렴해요. 로컬 LLM은 무료지만 컴퓨터 성능이 좋아야 해요.

Q: 요금 폭탄 맞을까 봐 걱정돼요.
A: DeepSeek은 월 15,000원 정도면 일반적인 사용은 충분해요. API 제공사에서 사용량 알림을 설정할 수 있습니다.

24장 · 부록 — 명령어 빠른 참조

자주 쓰는 Hermes 명령어 모음

대화 중 슬래시 명령어

중요 파일 경로