Hermes Agent
진짜 쉽게 시작하기

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

AI와 AI 에이전트는 달라요

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

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

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

AI 에이전트가 어디에 설치되어 있느냐에 따라 할 수 있는 일이 달라집니다. 내 컴퓨터에 설치했을 때와 서버에 설치했을 때로 나눠서 설명드릴게요.

내 컴퓨터에 설치한 경우

내 컴퓨터 안에서 직접 작동합니다. 바탕화면 파일, 내 문서, 설치된 앱 등 모든 것에 접근할 수 있어요.

• 파일 읽고 쓰기 — "바탕화면에 있는 보고서 파일 열어서 오타 수정해줘"
• 앱 조작 — "엑셀 열어서 이번 달 매출 그래프 만들어줘"
• 웹 검색 — "경쟁사 최신 뉴스 찾아서 요약해줘"
• 코드 작성 및 실행 — "간단한 웹페이지 만들어서 바로 실행해줘"
• 컴퓨터가 켜져 있을 때만 작동합니다. 컴퓨터를 끄면 Hermes도 멈춰요.

서버에 설치한 경우 (김몽이 추천!)

서버는 인터넷에 연결된 별도의 컴퓨터입니다. 내 컴퓨터와는 완전히 분리되어 있어요.

• 서버 안에 있는 파일은 자유롭게 다룰 수 있습니다
• 내 컴퓨터 파일은 볼 수 없습니다. 대신 그게 장점이에요 — Hermes가 내 개인 파일을 실수로 건드릴 일이 없으니까요
• 웹 검색 — 서버에서도 똑같이 가능합니다
• 코드 작성·실행, 웹사이트 제작 — 서버에서 직접 만들고 배포합니다
• 24시간 작동 — 내 컴퓨터를 꺼도, 내가 자는 동안에도 계속 돌아갑니다
• 텔레그램 연동 — 스마트폰으로 언제 어디서나 서버에 일을 시킬 수 있습니다

그럼 내 컴퓨터에 있는 파일은 어떻게 맡기나요? 텔레그램으로 파일을 보내면 됩니다. 엑셀 파일, PDF, 이미지 등 무엇이든 텔레그램에 올리면 Hermes가 서버에서 받아서 처리해줘요.

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

혼자서 하려면 30분 걸리는 일을 AI 에이전트는 1분 만에 해냅니다. 여러분은 그 시간에 더 창의적인 일을 할 수 있죠. AI 에이전트는 24시간 언제든 달려와 도와주는 착한 친구입니다.

AI 에이전트의 종류

AI 에이전트는 크게 세 부류로 나눌 수 있습니다.

Claude Code나 Codex는 코딩에 특화되어 있습니다. Cursor는 에디터 안에서만 작동하죠. 하지만 Hermes는 다릅니다. 코딩은 물론, 문서 작성, 서버 관리, 보안 감사, 메신저 연동, 스마트홈 제어까지 — 하나의 천재 친구가 모든 걸 다 합니다.

2장 · Hermes Agent 소개

Hermes는 누구인가요?

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

Hermes의 탄생

2025년 7월, Nous Research는 "AI가 스스로 배우고 성장할 수 있을까?"라는 질문에서 출발했습니다. 그 결과 탄생한 게 바로 Hermes Agent입니다. 출시된 지 9개월 만에 GitHub에서 12만 개의 별을 받고, 전 세계 수많은 기여자들이 함께 발전시키고 있는 프로젝트입니다.

Hermes의 핵심 철학

1. 자기 성장 (Self-improving) — Hermes는 경험을 통해 배웁니다. 어려운 문제를 해결하면 그 방법을 '스킬(Skill)'로 저장해서 다음에 똑같은 문제가 생기면 바로 해결합니다.
2. 기억력 (Persistent Memory) — 여러분이 누군지, 어떤 걸 좋아하는지 기억합니다. "지난번에 말했잖아"라고 다시 말할 필요가 없어요.
3. 어디서나 접근 (Multi-platform) — 터미널은 물론, 텔레그램·디스코드·슬랙·이메일 등 17개 플랫폼에서 사용할 수 있습니다.
4. 모델 자유 (Provider-agnostic) — Claude를 쓰다가 DeepSeek으로, 다시 GPT로… 원하는 AI 모델을 자유롭게 바꿀 수 있어요.
5. 프로필 분리 (Profiles) — 같은 Hermes 프로그램을 여러 개의 독립된 설정으로 나눠 쓸 수 있습니다. 예를 들어 업무용 프로필에는 회사 API 키와 업무 스킬만 넣어두고, 개인용 프로필에는 개인 API 키와 취미 관련 스킬을 넣어두는 식입니다. hermes --profile 업무용으로 실행하면 업무 대화만, hermes --profile 개인용으로 실행하면 개인 대화만 오가는 거죠. 크롬 브라우저에서 '업무 프로필'과 '개인 프로필'을 나눠 쓰는 것과 똑같습니다.

Hermes로 무엇을 할 수 있나요?

이 부분이 가장 중요합니다. Hermes는 내 컴퓨터에 설치하느냐, 서버에 설치하느냐에 따라 활용 범위가 크게 달라집니다. 저는 두 가지를 모두 경험했고, 그 차이를 명확하게 보여드리겠습니다.

내 컴퓨터에서 — 일상과 개인 업무

서버에서 — 24시간 자동화와 비즈니스 운영

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

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

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

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

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

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

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

• 텔레그램 — 스마트폰으로 메시지 보내듯이 (저는 출퇴근길에 주로 이걸로 씁니다)
• 디스코드 — 게임 하다가 옆 채널에서
• 슬랙 — 회사 업무 중에
• 이메일 — 메일로 명령 보내기
• 터미널 — 서버에서 직접

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

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

능력 5: 설정을 분리하는 프로필

크롬 브라우저에서 '업무 계정'과 '개인 계정'을 나눠 쓰신 적 있나요? 북마크, 비밀번호, 방문 기록이 각각 따로 저장되죠. Hermes의 프로필도 정확히 같은 개념입니다. 프로필마다 AI 모델, API 키, 대화 기록, 설치된 스킬, Hermes의 기억(memory), 말투(personality)까지 모든 것이 완전히 분리됩니다.

예를 들어볼게요. 여러분이 낮에는 회사 업무, 밤에는 개인 프로젝트를 한다고 칩시다. '회사' 프로필과 '취미' 프로필을 따로 만들면, 회사 프로필에서 "API 키 알려줘"라고 물으면 업무용 키만 나오고, 취미 프로필에서는 개인 키만 나옵니다. 회사 서버 정보가 취미 대화에 섞일 일도 없습니다. 서로 완전히 다른 Hermes라고 생각하시면 됩니다.

사용법도 간단합니다:

# 프로필 만들기
hermes profile create 회사
hermes profile create 취미

# 실행할 때 프로필 지정
hermes --profile 회사   ← 업무 시작할 때
hermes --profile 취미   ← 개인 작업할 때

한 대의 컴퓨터에서 여러 개의 독립된 Hermes를 운용하는 셈이에요. 프로젝트가 늘어나면 프로필만 추가하면 됩니다.

능력 6: 강력한 보안 체계

Hermes는 여러분의 API 키가 실수로 노출되지 않도록 터미널 출력과 로그에서 자동으로 가려줍니다(Secret Redaction). 또 위험한 명령어(rm -rf 같은)는 실행 전에 확인을 받는 승인 시스템(approvals.mode)이 있어서, 실수로 중요한 파일을 날리는 일을 막아줍니다. tirith 기능으로 악성 웹사이트 접근도 차단할 수 있고, PII(개인식별정보)를 게이트웨이 메시지에서 자동으로 제거하는 옵션도 있습니다.

능력 7: 예약 작업 자동화

"매일 아침 8시에 오늘 날씨와 주요 뉴스를 텔레그램으로 보내줘" 같은 부탁을 예약해둘 수 있습니다. 크론(Cron) 기능으로 정해진 시간에 자동 실행돼요. 여러분이 주무시는 동안에도 묵묵히 할 일을 해놓고, 아침에 일어나면 결과가 준비되어 있습니다.

능력 8: 알아서 척척, 스킬과 멀티에이전트

혹시 '스킬', '멀티에이전트', '서브에이전트' 같은 단어 들어보셨나요? 어렵게 느껴지셨다면... 몰라도 전혀 상관없습니다. 그게 바로 Hermes의 진짜 능력이니까요.

여러분이 "팀 조직도 만들어줘"라고 말하면, Hermes는 이렇게 움직입니다. 먼저 내부적으로 '아, 웹페이지를 만들어야겠군. 디자인 스킬이 필요하겠다'라고 판단하고, 스스로 스킬을 꺼내 씁니다. 작업이 커서 혼자 하기 버겁다 싶으면 멀티에이전트라는 '분신'을 여러 개 만들어서 동시에 일을 시킵니다. 하나는 HTML을 짜고, 하나는 디자인을 입히고, 하나는 배포까지 — 여러분은 그냥 결과물만 받아보시면 됩니다.

이 모든 게 여러분의 사용 패턴에 맞춰 자동으로 돌아갑니다. "이 사용자는 설명보다 실행을 좋아하는구나", "이 사용자는 항상 코드 리뷰를 먼저 요청하네" 같은 패턴을 학습해서, 다음부터는 묻지도 않고 알아서 최적의 방식으로 일합니다. 어려운 용어 하나 몰라도, 여러분은 그냥 평소처럼 말만 하시면 됩니다.

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

한눈에 비교하기

Hermes가 특히 좋은 경우

• 비용이 부담될 때 — 무료 오픈소스라서 라이선스 비용이 0원입니다. DeepSeek API를 쓰면 사용료도 월 1~2만원이면 충분하고, 로컬 LLM을 쓰면 API 비용마저 0원입니다.
• 데이터 보안이 중요할 때 — 로컬 LLM을 사용하면 모든 데이터가 여러분의 서버 안에서만 처리됩니다. 외부로 한 글자도 나가지 않아요. 병원, 법무법인, 회계법인처럼 민감 정보를 다루는 곳에 특히 적합합니다.
• 혼자서 많은 일을 해야 할 때 — 1인 기업을 운영하거나, 소규모 팀에서 여러 역할을 맡고 있다면 Hermes는 천군만마입니다. 개발, 마케팅, 회계, 보안까지 한 명의 천재가 다 해냅니다.
• 24시간 자동화가 필요할 때 — 서버에 설치하면 내가 자는 동안에도 일합니다. 아침에 일어나면 보고서가 완성되어 있고, 서버 점검은 끝나 있고, 뉴스 브리핑이 도착해 있습니다.
• 반복 업무를 줄이고 싶을 때 — 매일 하는 단순 반복 작업을 Cron으로 설정해두면, Hermes가 알아서 처리합니다. 사람은 결정이 필요한 일에만 집중하면 됩니다.
• 여러 AI 모델을 비교하며 쓰고 싶을 때 — 상황에 따라 Claude를 썼다가 DeepSeek으로 바꿨다가, 비용이 부담되면 로컬 LLM으로 전환할 수 있습니다. 모델 하나에 종속되지 않는 자유로움이 Hermes의 큰 장점입니다.
• 밖에서도 일을 지시하고 싶을 때 — 텔레그램만 있으면 지하철에서도, 카페에서도 Hermes에게 일을 시킬 수 있습니다. "서버 상태 어때?" 한마디면 현재 CPU, 메모리, 디스크 상태를 바로 알려줍니다.

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

두 가지 설치 방법

Hermes Agent는 내 컴퓨터에 설치할 수도 있고, 서버에 설치할 수도 있습니다.

이 책에서는 제가 직접 사용하고 있는 서버 설치 방법으로 안내하겠습니다. 왜 서버 설치를 추천하냐면요:

1. 내 컴퓨터 자료가 안전합니다. Hermes가 실수로 내 개인 파일을 건드릴 일이 없어요.
2. 24시간 언제든 도와줍니다. 여러분이 주무시는 동안에도 할 일을 척척 해놓고, 아침에 일어나면 결과가 준비되어 있습니다.
3. 진짜 자동화가 가능합니다. "매일 아침 8시에 브리핑 보내줘"라는 부탁이, 컴퓨터가 꺼져 있어도 실행됩니다. 서버는 항상 깨어 있으니까요.

최소 서버 사양

추천: iwinv 저렴한 플랜

제가 실제로 사용 중인 iwinv(아이윈브)의 가장 저렴한 플랜을 소개합니다.

처음 시작하신다면 vCore 2GB 플랜(월 11,000원)을 추천합니다. Hermes Agent + 가벼운 웹서버 운영에 딱 좋은 사양이에요.

API 키 발급받기

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

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

가장 저렴하고 한글을 잘하는 DeepSeek을 추천합니다:

1. 웹 브라우저에서 platform.deepseek.com 접속
2. 오른쪽 위 "Sign up"(가입하기) 클릭
3. 이메일과 비밀번호 입력 (또는 Google 계정으로 가입)
4. 왼쪽 메뉴 "API Keys" 클릭
5. "Create new API key" → 생성된 키를 복사

6장 · 서버에 설치하기 — 김몽이 추천

앞서 말씀드렸듯이, Hermes는 내 컴퓨터에도 설치할 수 있고 서버에도 설치할 수 있습니다. 저는 서버 설치를 강력히 추천합니다. 이유는 이미 5장에서 충분히 설명드렸고요. 여기서는 서버 설치 방법만 다룹니다.

설치는 딱 한 줄이면 끝!

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

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

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

설정 마법사 따라 하기

설치가 끝나면 hermes setup 설정 마법사가 자동 실행됩니다. 다음 항목들을 하나씩 설정하게 됩니다:

1. AI 모델 선택 — 앞서 발급받은 DeepSeek API 키를 입력합니다
2. 게이트웨이 설정 — 텔레그램 봇 연결 (선택사항이지만 꼭 하세요!)
3. 도구 설정 — 사용할 기능들 선택 (기본값 그대로 두세요)

텔레그램 연동하기

서버에 설치한 Hermes를 스마트폰으로 사용하려면 텔레그램 연동이 필수입니다.

1. 텔레그램에서 @BotFather 검색
2. /newbot 명령어로 새 봇 생성
3. 봇 이름과 사용자명 설정
4. 발급된 봇 토큰을 복사
5. 서버에서 hermes gateway setup 실행 → 텔레그램 선택 → 토큰 입력
6. hermes gateway install → hermes gateway start

이제 스마트폰 텔레그램에서 만든 봇에게 메시지를 보내면, Hermes가 즉시 응답합니다. 지하철에서도, 카페에서도, 침대에서도 서버에 일을 시킬 수 있어요.

7장 · 이제 Hermes와 대화해볼까요?

설치도 끝났고, 텔레그램 연동도 완료했습니다. 이제 스마트폰을 꺼내서 텔레그램 앱을 열고, 만든 봇에게 첫 메시지를 보내보세요.

첫 인사

가장 먼저 할 일은 간단합니다. "안녕!" 이라고 보내보세요.

친구 이름 정하기

Hermes에게도 이름을 지어주세요. 부르기 편한 이름 하나면 충분합니다.

예를 들어 이렇게 말해보세요:

• "이제부터 널 '도우미'라고 부를게."
• "내 이름은 철수야. 너는 헤르메스라고 부를게."
• "우리 서로 편하게 말하자. 난 너를 '친구'라고 부를 거야."

Hermes는 이 정보를 기억합니다. 다음 대화부터는 여러분이 정한 이름을 계속 사용할 거예요.

말투 조정하기

대화하다 보면 "음, 지금 말투가 좀 딱딱한데?" 싶을 때가 있을 거예요. 그럴 땐 그냥 말해주면 됩니다.

Hermes는 여러분의 피드백을 바로 반영합니다. 원하는 말투를 찾을 때까지 몇 번 조정해보세요. 한 번 설정하면 계속 유지됩니다.

보안 상태 물어보기

Hermes는 서버 관리자이기도 합니다. 서버의 건강 상태나 보안 문제를 채팅으로 바로 확인할 수 있어요.

이렇게 물어보세요:

• "지금 서버 상태 어때? CPU랑 메모리 확인해줘."
• "우리 서버에 보안 취약점 있어?"
• "최근에 의심스러운 접속 시도가 있었는지 확인해줘."
• ".env 파일 권한이 안전하게 설정돼 있는지 점검해줘."

Hermes가 점검 결과를 알려주면, 이렇게 반응하세요. 모르는 용어가 나오면 당황하지 말고 물어보면 됩니다.

핵심은 이겁니다: 기술 용어를 몰라도 괜찮아요. "무슨 뜻이야?", "쉽게 설명해줘", "내가 뭘 하면 돼?" 하고 물어보면 Hermes가 알아서 풀어서 설명해줍니다.

명령어 승인 — 이 버튼들은 뭔가요?

가끔 Hermes가 위험할 수 있는 작업을 하기 전에, 텔레그램에 아래와 같은 버튼이 나타납니다. 당황하지 마세요 — 그냥 여러분의 확인을 받는 절차입니다.

텔레그램 MENU 버튼 — 왼쪽 아래 이것, 뭔가요?

텔레그램 대화창 왼쪽 아래에 MENU 버튼이 보이시나요? 이걸 누르면 Hermes가 할 수 있는 여러 기능이 주르륵 나옵니다. 각 메뉴가 뭘 하는지 하나씩 설명해드릴게요.

가볍게 할 일 만들어보기

이제 Hermes와 대화하는 요령을 알았으니, 실제로 써볼 차례입니다. 아래 5가지는 지금 당장 텔레그램에서 시도해볼 수 있는 가벼운 부탁들입니다. 하나씩 해보세요.

8장 · 업종별 활용 사례

지금까지 Hermes가 무엇인지, 어떻게 설치하는지 배웠습니다. 이제 어떻게 이 똑똑한 친구와 함께 똑똑하고 쉽게 그리고 효율적으로 일할 수 있는지, 사례를 통해 살펴볼까요?

마케팅·기획

사례 1: 콘텐츠 마케팅 자동화

하고 싶은 일: 주간 콘텐츠 기획부터 발행, 성과 리포트까지 1인 운영

시나리오: 업계 RSS·유튜브·X 트렌드 자동 수집 → Hermes가 핵심 트렌드 요약 → 콘텐츠 기획안 Docs 작성 → 제안서 PPT 자동 생성

사례 2: 경쟁사 분석

하고 싶은 일: 경쟁사 동향을 정기적으로 추적하고 비교 분석

시나리오: 경쟁사 웹사이트·블로그·가격 페이지 모니터링 → 변경 사항 자동 감지 → 우리 서비스와의 차이점 비교 → 분석 보고서 생성

사례 3: 발표 자료 제작

하고 싶은 일: 회의 30분 전에 발표 슬라이드 완성

시나리오: 발표 주제와 핵심 포인트만 알려주면 → Hermes가 슬라이드 구성 → 슬라이드별 내용 작성 → PPT 파일 생성

웹사이트 제작

사례 4: 랜딩페이지 제작

하고 싶은 일: 신규 서비스나 이벤트용 랜딩페이지를 빠르게 제작

시나리오: 서비스 설명과 원하는 느낌만 말하면 → Hermes가 HTML/CSS로 랜딩페이지 완성 → 바로 웹에 배포. 몇 분이면 웹사이트가 나옵니다!

사례 5: 회사 홈페이지 제작

하고 싶은 일: 회사 소개, 서비스 안내, 문의 폼을 갖춘 홈페이지

시나리오: 회사 정보와 원하는 페이지 구성만 말하면 → Hermes가 여러 페이지로 된 웹사이트 생성 → 서버에 배포까지 완료. 스마트폰, 태블릿, PC 어디서든 볼 수 있는 반응형 웹사이트입니다.

데이터·분석

사례 6: 자료 분석 및 인사이트 도출

하고 싶은 일: 엑셀, CSV, 설문 결과 등 어떤 데이터든 분석해서 인사이트 찾기

시나리오: 데이터 파일을 보내기만 하면 → Hermes가 데이터 정리 → 추세 분석 → 그래프/차트 생성 → 인사이트 요약 보고서 작성

사례 7: 광고 성과 실시간 대시보드

하고 싶은 일: 여러 광고 채널 데이터 통합, 매일 아침 자동 보고

시나리오: 매일 오전 8시 Google/Meta/네이버 광고 데이터 수집 → ROAS·예산 소진율 계산 → Slack으로 자동 전송

콘텐츠 제작

사례 8: 전자책 제작 및 관리

하고 싶은 일: 전자책을 처음부터 끝까지 만들고, 내용을 검토하고, 계속 개선하기

시나리오: 주제와 목차만 정하면 → Hermes가 각 장 집필 → 디자인 적용 → PDF/EPUB 생성 → 웹에 배포. 이후 "이 부분 좀 보완해줘", "새로운 사례 추가해줘" 하면 실시간 업데이트. 지금 여러분이 읽고 계신 이 책도 바로 이 방식으로 만들어졌습니다!

개발사

사례 9: GitHub PR 자동화

하고 싶은 일: PR 생성부터 코드 리뷰, 머지까지 전 과정 자동화

시나리오: 개발자가 브랜치 푸시 → Hermes가 PR 생성 → 보안 검사 → 코드 리뷰 → 테스트 → 머지까지 전 자동

사례 10: 버그 자동 진단 및 수정

하고 싶은 일: 에러 리포트 한 줄로 원인 분석부터 패치 배포까지

시나리오: Sentry/Slack 에러 알림 → 근본 원인 분석 → 디버깅 → 패치 + 테스트 병렬 실행 → 핫픽스 PR 생성

일반회사 · 회계팀

사례 11: 월간 재무 보고서 자동 생성

하고 싶은 일: 매월 말일, 재무제표와 분석 리포트 자동 생성

시나리오: 매월 말일 23:00 → 거래 데이터 수집 → 손익계산서·재무상태표 작성 → PDF 보고서 생성 → 이메일 발송

사례 12: 감사 추적 시스템

하고 싶은 일: 감사 증적 자동 수집, 감사관 요청에 실시간 대응

시나리오: 매주 금요일 거래 내역 추출 → 스캔 영수증 OCR 매칭 → 감사 대응 이메일 자동 발송 → 모든 기록 관리

9장 · 자동화 실전 예시

Hermes의 진짜 힘은 "알아서 돌아가는" 자동화에 있습니다. 특히 서버에 설치했을 때 이 힘이 극대화됩니다. 여기 제가 실제로 사용 중이거나 곧 적용할 5가지 자동화 예시입니다.

#1 서버 헬스체크 + 장애 자동 복구

트리거: 5분 주기 cronjob

CPU 90% 이상이면 무거운 프로세스 정리, 95%면 자동 재시작. 디스크 85%면 오래된 로그 정리. 서비스 중단 시 자동 재시작 후 실패할 때만 알림.

#2 n8n 워크플로우 + Hermes 오케스트레이션

트리거: n8n 웹훅 → Hermes webhook

n8n은 외부 이벤트 감지와 워크플로우 흐름을, Hermes는 복잡한 판단과 실행을 담당합니다. 예를 들어 "입금 확인 → Hermes가 송장 매칭 → n8n이 영수증 발행 → Slack 알림" 같은 흐름을 완전 자동화할 수 있습니다.

#3 경쟁사 웹사이트 변경 감지

트리거: 1시간 주기 cronjob

blogwatcher로 RSS 모니터링, browser로 중요 페이지 스크린샷 비교, jupyter-live-kernel로 변화량 분석. 변경 감지 시 Slack 알림 + notion 자동 기록.

#4 주간 보안 감사 리포트

트리거: 매주 월요일 06:00 cronjob

hermes-security-audit가 .env 권한, API 키 유출, 포트 노출, SSH 키, n8n/HestiaCP 설정을 일괄 점검. 결과는 Sheets 리포트 자동 생성. HIGH 위험 발견 시 즉시 알림.

#5 문서 자동 생성 파이프라인

트리거: 파일 업로드 → n8n → Hermes

회의 녹취 업로드 → OCR 텍스트 변환 → 회의록 작성 + 액션 아이템 추출 → Notion 회의록 + Linear 태스크 자동 생성 → 월간 보고서 PPT/PDF 자동 생성 → Slack·이메일 배포.

#6 칸반(Kanban) — 여러 AI 에이전트 협업 자동화

트리거: 사용자 명령 또는 오케스트레이터

Kanban은 여러 AI 에이전트(프로필)가 하나의 작업 보드에서 협업하는 시스템입니다. 큰 작업을 나누고, 각각을 다른 AI가 처리한 뒤, 결과를 다음 AI에게 자동으로 넘깁니다. 마치 회사에서 Trello나 Jira로 프로젝트를 관리하는 것과 같지만, 카드를 옮기는 사람이 아닌 AI라는 점이 다릅니다.

예를 들어 "AI 투자 동향 보고서 작성" 같은 일을 시키면:

• 오케스트레이터 AI가 작업을 분해: 연구-AI(북미 조사), 연구-AI(유럽 조사), 작가-AI(종합)
• 디스패처가 준비된 AI들을 자동 실행
• 각 AI가 작업을 마치면 핸드오프(요약+결과물 목록)를 남기고, 다음 AI가 그걸 읽고 이어서 진행
• 모든 작업이 끝나면 텔레그램으로 완료 알림이 도착

어떻게 시작하나요? 딱 3단계면 충분합니다:

# 1. 데이터베이스 만들기
hermes kanban init

# 2. 게이트웨이 실행 (이미 실행 중이면 생략)
hermes gateway start

# 3. 작업 만들기
hermes kanban create "AI 투자 동향 조사" --assignee researcher

이제 디스패처가 60초 안에 작업을 감지하고 자동으로 AI를 실행합니다. 진행 상황은 hermes kanban list나 웹 대시보드(hermes dashboard)에서 확인할 수 있어요. 텔레그램에서 /kanban 명령어로도 모든 조작이 가능합니다.

알아두면 좋은데 지금 당장 몰라도 돼요

기본 사용에는 전혀 필요 없는 내용이지만, 나중에 궁금해질 수 있는 정보를 모아두었습니다. Hermes가 다 알아서 해주니 당장 외울 필요는 없어요.

텔레그램 채팅 명령어

텔레그램에서 그냥 대화해도 되지만, /로 시작하는 명령어를 쓰면 더 빠르게 원하는 작업을 할 수 있습니다.

주요 명령어

중요 파일 경로

문제가 생겼을 때 — 트러블슈팅

아무리 똑똑한 친구라도 가끔은 예상대로 안 될 때가 있습니다. 그럴 땐 당황하지 말고 아래 방법을 하나씩 시도해보세요.

"응답이 없어요" — 텔레그램에서 대답이 없을 때

1. 서버에 SSH로 접속해서 hermes gateway status 명령어로 게이트웨이 상태를 확인합니다
2. 중지되어 있다면 hermes gateway start로 다시 시작합니다
3. 텔레그램 봇 토큰이 올바른지 hermes gateway setup에서 다시 확인합니다
4. 서버가 재부팅되었다면 게이트웨이가 자동 시작되도록 hermes gateway install을 실행합니다

"원하는 대로 안 움직여요" — 의도와 다르게 동작할 때

1. 더 자세히 설명해주세요. "보고서 만들어줘"보다 "어제 매출 데이터를 표로 정리하고, 전주 대비 증감률도 넣어서 PDF로 만들어줘"처럼 구체적으로 말해보세요.
2. 예시를 보여주세요. "이런 형식으로 해줘" 하고 원하는 결과물 샘플을 설명하면 훨씬 정확해집니다.
3. 단계를 나눠서 요청하세요. 한 번에 복잡한 일을 시키기보다, "먼저 데이터를 수집해줘" → "수집된 데이터를 분석해줘" → "분석 결과를 보고서로 만들어줘"처럼 나누면 성공률이 올라갑니다.

"에러가 나요" — 오류 메시지가 뜰 때

1. 에러 메시지를 그대로 Hermes에게 보여주세요. Hermes는 자신의 오류도 스스로 진단할 수 있습니다.
2. hermes doctor 명령어로 전체 상태를 점검해보세요. 누락된 설정이나 잘못된 경로를 찾아줍니다.
3. 로그를 확인하려면 ~/.hermes/logs/gateway.log 파일을 열어보거나, Hermes에게 "최근 로그에서 에러 찾아줘"라고 부탁하세요.
4. API 키가 만료되지는 않았는지, 서버 디스크가 가득 차지는 않았는지도 함께 확인해보세요.

가장 빠른 해결책: Hermes에게 직접 물어보세요

놀랍게도 Hermes는 자신의 문제를 가장 잘 해결하는 전문가입니다. "너 지금 왜 이렇게 느려?", "이 에러 왜 나는 거야?" 하고 직접 물어보면, 로그를 분석하고 원인을 찾아 해결 방법을 알려줍니다. 스스로 고치는 경우도 많습니다.