Hermes Agent 설치부터 Oh My Hermes 얹기까지: 차이와 활용법 정리
Nous Research의 Hermes Agent 설치법, 그 위에 올리는 oh-my-hermes(OMH) 설치법, 둘의 역할 차이와 활용 예, 설정 백업 같은 주의점을 2026년 11월 4일 README 기준으로 정리했다.
이 글은 2026년 11월 4일 기준으로 두 프로젝트의 공식 저장소 README와 제3자 검토 글 한 편을 읽고 정리한 것입니다. 글쓴이가 두 도구를 직접 설치해 장기간 써 본 후기는 아닙니다. 설치 전에는 반드시 최신 README를 다시 확인하세요.
한눈에 보기
- Hermes Agent는 Nous Research가 만든 오픈소스(MIT) AI 에이전트 본체입니다. 대화로 일을 시키고, 경험에서 스킬을 만들고, 세션을 넘어 기억을 쌓는 것이 핵심입니다.
- **Oh My Hermes(OMH)**는 Hermes 위에 얹는 별도 프로젝트(MIT)입니다. 작업 종류별로 모델과 추론 강도를 정해 주고, 큰 목표를 병렬 작업으로 쪼개 돌리는 "운영 레이어"로 소개합니다. README는 Hermes 자체를 패치하거나 대체하지 않는다고 설명하지만, 뒤에서 보듯 설치 과정에서 Hermes의 설정 파일은 바뀝니다. 개발 주체는 Nous Research가 아닌 별도 저장소(rlaope)이며, 둘의 관계는 확인하지 못했습니다.
- 설치 순서는 Hermes 먼저, OMH는 그다음입니다. OMH는 Hermes 전용 플러그인이라 Hermes가 없으면 쓸 수 없습니다.
1단계: Hermes Agent 설치
공식 저장소는 NousResearch/hermes-agent입니다. 한 줄 설치 명령은 플랫폼별로 다릅니다.
Linux, macOS, WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows (PowerShell, 네이티브)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
README 기준 안내는 다음과 같습니다.
- Windows는 WSL 없이도 지원한다고 적혀 있습니다.
- 설치 위치는 네이티브가
%LOCALAPPDATA%\hermes, WSL2가~/.hermes입니다. - 안드로이드 Termux는 데스크톱 스크립트가 아니라 별도 안내를 따라야 합니다.
- 백신이 번들된
uv.exe를 격리할 수 있는데, README는 오탐이라고 설명합니다. 다만 백신 예외 설정은 위험을 감수하는 선택이니, 파일 출처를 직접 확인한 뒤 판단하세요.
설치 후에는 셸 설정을 다시 읽고 실행합니다.
source ~/.bashrc # zsh라면 ~/.zshrc
hermes
처음 설정할 때 쓰는 명령
| 명령 | 하는 일 |
|---|---|
hermes | 대화형 CLI 시작 |
hermes setup | 설정 마법사 실행 |
hermes model | LLM 제공자와 모델 선택 |
hermes tools | 쓸 도구 켜고 끄기 |
hermes gateway | 메신저 게이트웨이 시작 |
hermes update | 최신 버전으로 업데이트 |
hermes doctor | 문제 진단 |
모델은 Nous Portal, OpenRouter, OpenAI 호환 사용자 지정 엔드포인트 등에서 고를 수 있다고 안내돼 있습니다.
2단계: Oh My Hermes 설치
oh-my-hermes(OMH)의 공식 저장소는 rlaope/oh-my-hermes입니다. 선행 조건은 Hermes 설치, Python 3.11 이상, Node 18 이상(npm·Bun 경로)입니다.
먼저 백업하세요. 뒤에서 설명하듯
omh setup은 Hermes의config.yaml을 고칩니다. 실행 전에~/.hermes(Windows 네이티브는%LOCALAPPDATA%\hermes)를 통째로 복사해 두세요.
설치 방법은 여러 가지입니다. 아래 한 줄 설치 명령(curl ... | sh, irm ... | iex)은 Hermes 쪽 명령도 마찬가지로 스크립트를 내려받아 바로 실행하는 방식이므로, 내용이 궁금하면 먼저 내려받아 읽어 본 뒤 실행하는 편이 안전합니다.
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/rlaope/oh-my-hermes/main/install.sh | sh
# Homebrew
brew install rlaope/tap/omh
# Bun 또는 npm
bun install -g oh-my-hermes
npm install -g oh-my-hermes
# Windows (PowerShell 5.1 이상)
irm https://raw.githubusercontent.com/rlaope/oh-my-hermes/main/install.ps1 | iex
README는 어느 설치 방법이든 그다음에 omh setup을 실행하라고 안내합니다. 상태 점검은 omh doctor, 업그레이드는 omh update입니다. README에는 Hermes의 스킬 탭 기능으로 라우팅 스킬 하나만 설치하는 경로도 나와 있는데, 이 경로가 config.yaml을 바꾸는지, omh setup이 따로 필요한지는 확인하지 못했습니다.
hermes skills tap add rlaope/oh-my-hermes
hermes skills install rlaope/oh-my-hermes/skills/omh-routing --yes
omh setup이 바꾸는 것: 설정 백업이 필요한 이유
OMH를 격리된 환경에서 검토한 국내 블로그 글(2026년 9월 15일, npm 2.0.3 기준)에 따르면 omh setup은 Hermes의 config.yaml을 네 군데 고칩니다(외부 스킬 폴더, 플러그인 활성화, 기억 제공자, 화면 스킨). 특히 기억 제공자(memory.provider)가 omh로 바뀌는 점을 가장 큰 위험으로 짚었습니다. 이 변화가 Hermes 기억 동작에 실제로 어떤 영향을 주는지는 그 글에서도 검증하지 않았다고 하니, 앞서 말한 "Hermes를 패치하지 않는다"는 설명은 코드 기준이고 설정은 바뀐다고 이해하면 됩니다. 아래 내용은 모두 2.0.3 기준이며, 이후 버전에서 달라졌는지는 확인하지 못했습니다.
- 옵션 순서가 중요합니다. 전역 옵션
--hermes-home <경로>는 서브커맨드 앞에 써야 하고(omh --hermes-home <경로> setup), 뒤에 붙이면 무시되어 기본 홈이 수정됐다고 합니다. - 제거 명령
omh uninstall --all은~/.omh와 플러그인 폴더만 지우고,config.yaml의 등록 네 곳은 남았다고 합니다. 완전히 되돌리려면 설치 전에 만든config.yaml백업으로 복구해야 합니다. - 설치 중 sudo나 API 키 입력은 요구하지 않았고, 텔레메트리는 문서상 기본으로 꺼져 있다고 합니다.
이 내용은 한 사람의 검토이고 Windows 경로와 omh update는 검증 범위 밖이었다고 하니, 참고용으로만 보세요. 그래서 위의 백업 권고가 실용적인 결론입니다.
Hermes Agent와 Oh My Hermes의 차이
| 구분 | Hermes Agent | Oh My Hermes |
|---|---|---|
| 정체 | 에이전트 본체 | Hermes 위에 얹는 플러그인과 CLI |
| 만든 곳 | Nous Research | 별도 저장소(rlaope), Nous Research와의 관계는 확인 못 함 |
| 핵심 가치 | 스스로 만드는 스킬, 세션 간 기억, 메신저 연동 | 작업별 모델 라우팅, 병렬 워크플로, 증거 표시 |
| 단독 사용 | 가능 | 불가(Hermes 필요) |
| 대표 명령 | hermes, hermes setup | omh setup, omh model, /dag-ulw |
| 라이선스 | MIT | MIT |
한 줄로 말하면 Hermes는 "일하는 에이전트", OMH는 "그 에이전트가 일을 나눠 맡기는 방식을 정해 주는 운영 규칙"입니다.
Hermes Agent가 하는 일
- 기억과 스킬: 어려운 작업을 마친 뒤 스킬을 만들어 두고 쓰면서 다듬습니다. 과거 대화를 검색하고 요약해 이어 쓸 수 있습니다.
- 게이트웨이: README 기준으로 프로세스 하나로 텔레그램, 디스코드, 슬랙, 왓츠앱, 시그널, 이메일, CLI를 연결합니다. 서버에 띄워 두고 휴대폰 메신저로 부리는 사용 방식이 가능합니다.
- 도구와 실행 환경: README가 40개 이상이라고 소개하는 도구와 MCP 연동, 하위 에이전트 병렬 실행, 내장 크론 스케줄러가 있습니다. 실행 환경은 README에 로컬, Docker, SSH, Modal, Daytona, Vercel Sandbox 여섯 가지가 내장 백엔드로 나옵니다.
- 이사하기 쉬움:
hermes import-agent openclaw처럼 다른 에이전트(claude-code,codex,cursor포함)의 설정을 가져오는 명령이 있습니다.
Oh My Hermes가 더하는 일
- 모델 라우팅:
ultrabrain,deep,quick같은 작업 범주마다 모델 순서와 추론 강도를 정합니다. 제공자가 모델을 거부하면 다음 모델로 넘어가는 폴백 체인도 둡니다.omh model로 고릅니다. /dag-ulw: 큰 목표를 작은 노드의 그래프로 쪼개 병렬로 돌리고, 마지막에 별도 검증 노드를 둡니다.ulw-워크플로:ulw-interview,ulw-plan,ulw-work,ulw-loop등 README가 열 가지로 소개하는 워크플로를 프롬프트에 이름만 적어 부릅니다(여기서는 네 가지만 적었습니다).- 스킬 모음: README 기준 100종이 넘는
omh-*전문 스킬을 필요할 때만 불러옵니다. - 증거 표시: "Plan · not run", "Test · verified"처럼 계획만 한 것과 실제로 확인한 것을 구분해 표시합니다.
- 선택 기능: 언어 서버(LSP) 기반 심볼 조회와 이름 바꾸기가 있으며 기본은 꺼져 있습니다.
활용법: 이렇게 나눠 쓰면 좋습니다 (README 설명을 바탕으로 한 제안)
이 절은 두 README가 설명하는 기능을 바탕으로 글쓴이가 정리한 활용 제안이며, 직접 써 본 결과가 아닙니다.
Hermes만 쓰면 충분한 경우
- 개인 비서처럼 쓰기: 서버나 저렴한 VPS에 Hermes를 띄우고 텔레그램 등으로 일을 시키고, 크론으로 정기 작업(요약, 점검)을 맡깁니다.
- 반복 업무를 스킬로 굳히기: 같은 작업을 몇 번 시키면 스킬이 쌓이는 흐름을 기본 기능만으로 누릴 수 있습니다.
- 다른 에이전트에서 갈아타기:
hermes import-agent로 먼저 옮겨 보고 판단합니다.
OMH까지 얹을 만한 경우
- 코딩처럼 작업이 크고 단계가 많을 때: README에는 프롬프트에
ulw-loop: keep going until npm test passes라고 적는 예시가 있습니다. 이런 식으로 반복 수정을 맡기거나, 큰 일에는/dag-ulw로 병렬 분해와 검증을 맡깁니다. - 비용을 조절하고 싶을 때: 작업 범주별로 모델을 정하는 구조이니, 이론상 가벼운 일은
quick범주의 값싼 모델로, 어려운 설계는ultrabrain범주의 강한 모델로 보내도록omh model에서 나눕니다. - 계획과 실제를 구분하고 싶을 때: 증거 표시가 "돌려 봤는가"를 가려 주도록 설계돼 있다고 소개합니다.
시작 전 체크리스트
- Hermes의 최신 README에서 설치 명령과 Windows 지원 여부를 확인한다.
- Hermes를 먼저 설치하고
hermes setup,hermes model로 모델을 연결한 뒤, 평소 쓰는 작업이 돌아가는지 본다. - OMH를 얹기 전에 Hermes 홈 폴더와
config.yaml을 백업한다. - (kwt 글에서 나온 주의점) 가능하면 격리된 임시 홈에서
omh --hermes-home <경로> setup으로 먼저 시험한다. 옵션 위치에 주의한다. omh doctor로 상태를 점검한다.- 맞지 않으면
omh uninstall --all을 쓰고, 2.0.3 기준으로는config.yaml등록이 남았다고 하니 백업으로 되돌린다.
마무리
Hermes Agent는 기억과 스킬, 메신저 연동으로 "오래 곁에 두는 에이전트"를 지향하고, Oh My Hermes는 그 위에서 모델 배분과 병렬 작업, 검증 표시를 얹어 "큰 작업을 맡기는 방식"을 정리해 줍니다. 개인적인 의견으로는 처음에는 Hermes만 써서 감을 잡고, 큰 작업을 자주 맡기게 될 때 OMH를 얹어도 늦지 않다고 봅니다. 두 프로젝트 모두 빠르게 바뀌고 있으니 명령과 옵션은 설치 시점의 README를 기준으로 하세요.
출처
- NousResearch/hermes-agent README (2026-11-04 확인): https://github.com/NousResearch/hermes-agent — 설치 명령, 설정 명령, 기능 소개를 바탕으로 정리했습니다.
- rlaope/oh-my-hermes README (2026-11-04 확인): https://github.com/rlaope/oh-my-hermes — 설치 명령, CLI 명령, 기능 소개를 바탕으로 정리했습니다.
- 블로그 kwt, 「Hermes Agent를 “내 업무용 도구”로 바꾸는 oh-my-hermes: 설치·보안·제거 직접 검증」 (2026-09-15 검증 기준): https://blog.kwt.co.kr/oh-my-hermes-install-security-removal/ —
config.yaml변경 항목, 옵션 순서, 제거 후 잔존 설정 부분을 참고했습니다.