Hermes Agent 소개

기준일: 2026-07-26
문서 반영 버전: v2026.7.20 (Hermes Agent v0.19.0)
난이도: 초급
공식 기준: Hermes Agent Documentation, Learning Path, GitHub Releases

Hermes Agent는 Nous Research가 만든 self-improving 자율 AI 에이전트입니다. IDE에 묶인 코딩 코파일럿이나 단일 API 챗봇이 아니라, 터미널·데스크톱·메시징 게이트웨이·MCP·스킬·메모리를 한 런타임으로 묶어 “대화하는 AI”를 “반복 업무를 맡길 수 있는 에이전트”로 확장합니다.

공식 문서의 핵심 포지션은 closed learning loop입니다. 경험을 스킬로 만들고, 사용 중 스킬을 개선하며, 지식을 남기도록 스스로 유도하고, 세션을 넘어 사용자 모델을 깊게 쌓습니다.

핵심 개념

Hermes를 이해할 때는 네 가지 층으로 보면 쉽습니다.

층	역할	처음 볼 것
실행 표면	CLI, TUI, Desktop, Messaging Gateway, API/ACP	hermes, hermes --tui, hermes desktop, hermes gateway
지능 구성	메인 모델, 보조 모델, Tool Gateway, MoA	hermes model, hermes setup --portal
장기화 장치	메모리, 스킬, Curator, MCP, cron	~/.hermes, /skills, /learn, MCP 설정
격리·배포	local / Docker / SSH / Daytona / Modal / Singularity	terminal.backend, 보안 승인

Hermes의 장점은 단일 기능보다 조합에 있습니다. 예를 들어 “로컬 프로젝트를 읽고, GitHub MCP로 이슈를 만들고, 다음부터 같은 작업 절차를 스킬로 재사용하는” 흐름을 한 도구 안에서 구성할 수 있습니다.

학습 루프(Learning Loop)

구성	역할
Persistent Memory	MEMORY.md / USER.md에 사실·선호를 선별 저장
Agent-created skills	복잡한 작업 후 절차를 SKILL.md로 저장·개선
/learn	디렉터리·URL·방금 한 워크플로를 스킬로 증류
Background review	턴 종료 후 메모리/스킬 후보를 검토 (비용 모델 분리 가능)
write_approval	메모리·스킬 자동 쓰기를 사람이 승인하도록 게이트
Session search (FTS5)	과거 세션 전문 검색으로 “지난 대화” 회상
Honcho 등 memory provider	더 깊은 사용자 모델링·외부 장기 기억

선택 기준

Hermes Agent가 잘 맞는 경우:

• CLI와 메시징 플랫폼(Telegram, Discord, Slack, WhatsApp, Signal 등 20+ 채널)을 함께 쓰고 싶다.
• 프로젝트별 장기 메모리와 재사용 가능한 절차(스킬)가 중요하다.
• MCP 서버를 붙여 외부 시스템까지 다루고 싶다.
• VPS·Docker·Modal처럼 노트북 밖에서도 상시 에이전트를 돌리고 싶다.
• Claude Code나 OpenClaw와 다른 에이전트 실험 환경을 비교하고 싶다.

다른 선택이 나은 경우:

• Anthropic Claude Code 생태계만 쓰면 충분하다.
• 메신저 게이트웨이만 필요하고 코드 에이전트 기능은 약해도 된다.
• 회사 보안 정책상 외부 모델 라우팅이나 로컬 실행 권한을 아직 검토할 수 없다.

권장 학습 경로 (Stage 1–7)

Stage	목표	이 사이트 가이드	깊이
1	포지션·학습 루프	소개	비교
2	설치·업데이트	설치 → 업데이트
3	첫 대화·TUI	빠른 시작 → 첫 세션
4	모델·설정	Provider와 모델 · Configuration 전체	라우팅
5	메모리·스킬	메모리 → 스킬	컨텍스트
6	MCP·도구·Gateway	MCP 개요 · Tool Gateway · Tools/Code	MCP 실습
7	메시징·보안·장애	메시징 → 보안 → 트러블슈팅	아키텍처

공식 문서 기준 학습 경로 (목적별)

Hermes 공식 문서는 기능이 많기 때문에 처음부터 전부 읽기보다 목적별로 나눠 보는 편이 좋습니다.

목적	먼저 볼 카테고리	이 사이트의 대응 문서
5분 안에 첫 대화	Installation, Quickstart, CLI/TUI	설치, 빠른 시작, 첫 세션 운영
모델과 비용 제어	Configuration, Configuring Models, Provider Routing, Fallback Providers, Credential Pools	Provider와 모델 설정, Configuration, Provider 라우팅과 fallback
장기 기억과 재사용	Memory, Memory Providers, Skills, Curator, Context Files, Context References	메모리, 스킬, 컨텍스트 파일과 참조
안전한 병렬 작업	Sessions, Profiles, Git Worktrees, Checkpoints, Delegation, Kanban	세션과 프로필, 체크포인트와 Worktree, 위임과 Kanban
외부 채널 운영	Messaging Overview, WhatsApp, Telegram/Discord/Slack, Gateway Internals	메시징 게이트웨이, WhatsApp 연동, 보안과 승인
앱/서비스 내장	API Server, ACP, MCP, Tool Gateway, Python Library	MCP와 도구, Tool Gateway, TUI, Media, API/ACP
릴리즈 변화 추적	GitHub Releases	변경 이력

놓치기 쉬운 고급 카테고리

처음 가이드에서는 핵심 흐름을 다루지만, 운영 규모가 커지면 아래 카테고리도 빠르게 확인해야 합니다.

카테고리	공식 문서	확인할 질문
Memory Providers	Memory Providers	Honcho, Mem0, Supermemory 같은 외부 기억 저장소가 필요한가
Curator	Curator	agent-created skills가 오래되거나 중복될 때 누가 정리하는가
Code Execution	Code Execution	Python 실행으로 여러 도구 호출을 한 턴에 묶어도 되는가
Batch Processing	Batch Processing	agent trajectory를 대량 생성/평가해야 하는가
Runtime backends	Docker Backend, Hermes Docs Index	local, Docker, SSH, Daytona, Modal, Singularity 중 어디에서 실행할 것인가
Nix/Termux	Nix Setup, Termux	NixOS, Android, 모바일 실험 환경까지 지원해야 하는가
Tool Gateway	Tool Gateway · 로컬 가이드	web search, image gen, TTS, browser를 Nous 구독으로 묶을 것인가

실습

아직 설치 전이라면 이 장에서는 방향만 잡습니다.

1. Hermes가 맡을 첫 작업을 하나 정합니다.
2. 작업이 “한 번 묻고 끝나는 질문”인지 “반복 가능한 절차”인지 구분합니다.
3. 반복 절차라면 스킬 후보로 표시합니다.

예시:

목표: 매주 저장소 상태를 읽고 릴리스 노트를 초안 작성한다.
필요: 로컬 파일 읽기, git 로그 분석, GitHub 이슈 조회, 작성 규칙 기억.
Hermes 기능 후보: MCP, 메모리, 스킬, cron, /learn.

Hermes에 입력할 프롬프트

내 프로젝트를 처음 보는 기준으로 구조를 요약해줘.
반복 업무로 만들 수 있는 부분과 일회성 질문으로 남겨야 할 부분을 나눠줘.
실행 전에 위험한 명령은 반드시 나에게 확인해줘.

학습 경로를 고르는 프롬프트:

내 목표를 기준으로 Hermes 학습 경로를 짜줘.
설치, 모델 설정, memory providers, skills/curator, MCP, messaging,
code execution, batch processing, Docker/SSH/Daytona/Modal/Singularity/Nix/Termux 중 지금 볼 것과
나중에 볼 것을 나눠줘.

체크리스트

• Hermes를 “대화형 CLI”가 아니라 “메모리·스킬·학습 루프를 가진 에이전트”로 이해했다.
• 첫 실습 목표를 하나 골랐다.
• Claude Code, OpenClaw와 비교할 기준을 정했다.
• 로컬 권한과 외부 계정/API 키 사용 범위를 검토했다.
• Memory Providers, Curator, Code Execution, Batch Processing, runtime backends는 필요할 때 보는 고급 카테고리로 분리했다.

다음 단계

• 설치에서 안전하게 설치합니다.
• 빠른 시작 · 첫 세션에서 첫 대화를 엽니다.
• Provider와 모델 설정 · Configuration에서 모델 슬롯·전역 설정을 잡습니다.
• Tool Gateway에서 search/image/TTS/browser 묶음을 검토합니다.
• 보안과 승인에서 승인 경계를 정합니다.
• 변경 이력에서 최근 릴리즈 포인트를 확인합니다.
• Claude/OpenClaw와 비교에서 도구 선택 기준을 확인합니다.