hermes-agent는 2026년 가장 빠르게 성장한 오픈소스 AI 에이전트로, GitHub 스타 104,791개(2026-04-20 기준)를 기록했다. 이 가이드는 Hermes를 처음 시작하는 사람이 설치부터 첫 번째 워크플로를 실행하고, 자기 학습 루프를 이해하는 데까지 필요한 모든 내용을 다룬다.
Hermes Agent란
Hermes는 하네스 엔지니어링(Harness Engineering) 철학을 바탕으로 만든 에이전트다. 더 똑똑한 모델보다 더 나은 모델 주변 구조(다섯 레이어: 인스트럭션, 제약, 피드백, 메모리, 오케스트레이션)가 실제 성능을 결정한다는 관점이다. 덕분에 모델을 교체해도 에이전트는 그대로 성장한다.
핵심 차별점:
- 세션이 끝나도 메모리가 유지됨
- 사용할수록 스스로 스킬을 생성하고 개선함
- CLI, Telegram, Discord, Slack, 이메일 등 다양한 채널에서 동일한 에이전트와 대화
나는 어떤 사용자인가?
| 사용 목적 | 먼저 시작할 것 | 나중으로 미룰 것 |
|---|---|---|
| 터미널에서 더 나은 코딩 | CLI + 스킬 | Telegram, 크론 |
| 반복 작업 자동화 | 크론 + 메시징 게이트웨이 | 코드 실행 |
| 스마트폰에서 상시 대화 | Telegram + 음성 | CLI 워크플로 |
2분 만에 설치하기
curl -sSL https://get.hermes.run | bash설치 후 모델 프로바이더를 설정한다. 클라우드 모델(Claude, GPT-5.4) 또는 로컬 Ollama 모델 모두 지원된다:
hermes configure
# 프로바이더 선택 → 모델 선택 → API 키 입력 (로컬 모델은 불필요)모델 선택: 첫 주말의 흔한 실수
가장 비싼 모델로 시작할 필요가 없다. 입문에는 로컬 Ollama 모델로도 충분하다:
# Ollama 설치 후
ollama pull qwen2.5-coder:7b
# Hermes에서 Ollama 선택
hermes configure --provider ollama --model qwen2.5-coder:7b클라우드 모델은 복잡한 추론이 필요할 때 전환하면 된다. Hermes는 모델을 언제든 바꿀 수 있도록 설계되어 있다.
첫 번째 워크플로
hermesHermes CLI가 실행되면 자연어로 작업을 지시한다:
> 매일 아침 8시에 내 GitHub 알림을 요약해서 Telegram으로 보내줘
> 이 Python 스크립트의 버그를 디버깅해 줘
> 이 웹사이트 가격이 변하면 Slack으로 알림을 줘학습 루프: Hermes가 성장하는 방법
이것이 Hermes의 핵심 기능이다. 몇 번의 도구 호출마다 에이전트가 스스로 질문한다:
“방금 어떤 일이 있었나? 잘 된 것은? 실패한 것은? 스킬로 만들어야 하나?”
‘예스’라면 ~/.hermes/skills/에 마크다운 파일을 작성한다. 이 스킬은 이후 유사한 작업에서 자동으로 활용된다.
# 스킬 위치 확인
ls ~/.hermes/skills/
# 잘못된 스킬 삭제도 가능
rm ~/.hermes/skills/outdated-skill.md스킬은 평범한 마크다운이므로 직접 읽고 수정할 수 있다. 에이전트가 잘못 학습한 내용은 파일을 삭제하거나 수정하면 된다.
필수 스킬 먼저 설치하기
커뮤니티가 만든 스킬을 설치하면 처음부터 풍부한 기능을 쓸 수 있다:
# 예: GitHub 알림 스킬
hermes skills install github-notifications
# 예: 뉴스 요약 스킬
hermes skills install daily-briefingawesome-agent-skills에서 검증된 스킬 목록을 찾을 수 있다.
Telegram 연동 (자동화 운영자)
hermes gateway telegram --token YOUR_BOT_TOKENTelegram BotFather에서 봇 토큰을 발급받아 입력하면, 이후 스마트폰에서 Hermes와 대화할 수 있다.
정기 실행 설정
# 매일 오전 9시 실행
hermes cron add "0 9 * * *" "오늘의 뉴스를 요약해서 Telegram으로 보내줘"
# 크론 목록 확인
hermes cron list관련 문서
- hermes-agent — Hermes Agent 기술 소개 및 아키텍처
- awesome-agent-skills — 커뮤니티 스킬 큐레이션
- agent-harness — 에이전트 하네스 엔지니어링 개요
참고 자료
- Hermes Agent: The Complete Beginner’s Guide (Apr 2026) — hermesatlas.com (2026-04-23)
- NousResearch/hermes-agent — GitHub 공식 저장소