2026년 Hermes Agent(Nous Research, GitHub 약 17만 스타)는 세션 간 기억, Skill 자동 축적, Gateway로 Telegram 등 20+ 플랫폼 연결을 갖춘 자기진화 AI Agent로 주목받고 있습니다. 「설치 실패」「API Key 미설정」「Telegram 무응답」에 막혀 있다면, 한 줄 명령으로 환경을 구성하고 6단계 Runbook으로 hermes gateway 7×24 상시 운영까지, MacBook / VPS / Mac Mini M4 월 임대 중 어느 호스트가 프로덕션에 맞는지 정리합니다.
Hermes Agent는 채팅 껍데기가 아니라 MIT 라이선스의 상시 자율 Agent입니다. 유사 작업 완료 후 재사용 Skill을 자동 생성하고(커뮤니티 실측 동종 작업 token 약 38% 절감), SESSION → MEMORY.md → USER.md 3계층 기억으로 세션을 넘깁니다. LangGraph / CrewAI 같은 「오케스트레이션」이나 OpenClaw 같은 「채널 Gateway」와 비교해 Hermes의 차별점은 네이티브 Skill 진화 + 세션 간 영속 기억 + curl 한 줄 풀스택 설치입니다.
본 글은 「왜 Mac으로 바꾸는가」(VPS 마이그레이션 실측)나 「기억 아키텍처」(3계층 기억 하드웨어)를 반복하지 않고, 설치 Runbook에 집중합니다: macOS / Linux / WSL2 원클릭, hermes doctor, LLM 설정, 첫 대화, Telegram Bot, Gateway 데몬입니다.
페인 포인트: 문서가 분산되어 의존성과 API Key 중 무엇을 먼저 할지 모릅니다.
페인 포인트: 설치 후 hermes: command not found — PATH 미갱신이 흔한 원인입니다.
페인 포인트: Telegram DM은 되는데 그룹 무응답 — 프라이버시 모드와 재초대 순서 함정.
페인 포인트: 노트북 뚜껑 닫으면 Gateway 끊김, Skill 복리 중단.
페인 포인트: 헤드리스 VPS는 Camoufox 등 macOS 브라우저 자동화 경로 부재.
본 글 산출물: curl부터 hermes gateway start까지 검수 가능한 6단계 체크리스트.
공식 install.sh는 uv로 Python 3.11, Node.js 22, ripgrep, ffmpeg를 받아 ~/.hermes/hermes-agent/에 clone합니다. 아래 표는 용량 계획 참고용입니다(Nous Research 설치 문서와 커뮤니티 운영 경험, 2026-06 정리).
| 항목 | 최소 | 권장(7×24 + Gateway) |
|---|---|---|
| OS | macOS 12+ / Ubuntu 20.04+ / WSL2 | macOS 14+(Apple Silicon) 또는 Ubuntu 24.04 LTS |
| 메모리 | 4 GB(Gateway + 클라우드 API만) | 16 GB; 로컬 추론 32 GB 권장 |
| 디스크 | 약 1.5 GB(Skill 캐시 포함) | 20 GB SSD 이상 |
| 네트워크 | GitHub raw 및 LLM API 접근 | 안정적 저지연 egress(Telegram 체감에 영향) |
「Hermes 설치에서 가장 어려운 단계는 명령 자체보다, 뚜껑도 닫지 않고 새벽에도 끊기지 않는 머신을 고르는 것」
# macOS / Linux / WSL2 공식 원클릭 curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash # 헤드리스 서버는 브라우저 자동화 생략 가능 # curl -fsSL .../install.sh | bash -s -- --skip-browser source ~/.zshrc # 또는 source ~/.bashrc
설치 및 PATH 갱신: ✅ Hermes Agent installed at ~/.hermes 후 source ~/.zshrc, 새 터미널에서 hermes --version 확인합니다.
헬스 체크: hermes doctor가 Python, Node, ripgrep, ffmpeg, PATH, API Key 등 약 12항목을 진단합니다. 오류는 안내에 따라 해결합니다.
LLM 설정: 초보는 hermes setup; 또는 hermes model로 OpenRouter / Anthropic / OpenAI / Ollama 선택, Key를 ~/.hermes/.env에(예: hermes config set OPENROUTER_API_KEY sk-or-xxxx).
첫 대화: hermes CLI에서 「오늘 AI 뉴스 요약」「현재 디렉터리 파일 수」 등으로 툴체인을 확인합니다.
Telegram Bot: @BotFather /newbot으로 Token; @userinfobot으로 숫자 ID; hermes gateway setup에서 Telegram 선택 또는 TELEGRAM_BOT_TOKEN, TELEGRAM_ALLOWED_USERS 설정.
7×24 데몬: hermes gateway 테스트 후 hermes gateway install && hermes gateway start; macOS는 launchd, Linux는 sudo hermes gateway install --system + systemd.
기본적으로 Bot은 그룹에서 / 명령만 응답합니다. 그룹 @멘션에 반응하려면 BotFather에서 Group Privacy를 끄고 Bot을 내보낸 뒤 다시 초대해야 합니다 — 프로덕션에서 가장 흔한 「설치했는데 침묵」 원인입니다.
흔한 오류: API key not set → hermes model 재실행; ModuleNotFoundError: dotenv → 시스템 Python 대신 ~/.hermes/hermes-agent/venv/bin/hermes 사용; 업그레이드 후 설정 drift → hermes config check && hermes config migrate.
Hermes Skill 복리는 호스트 장기 온라인에 의존합니다. 아래 표는 빠른 의사결정용입니다(가용성은 운영 체감 수준, SLA 아님):
| 플랫폼 | 7×24 가용성 | Skill 복리 | 적합 시나리오 |
|---|---|---|---|
| 개인 MacBook | 뚜껑 닫으면 끊김(약 60%) | 잦은 중단 | POC만 |
| Raspberry Pi 4B 8GB | 약 88% | I/O 병목, 장기 작업 타임아웃 | 실험 |
| x86 VPS 4GB | 약 99.5% | 안정적이나 macOS 툴체인 부재 | Linux 전용 사용자 |
| Mac Mini M4 월 임대 | IDC 30일 온라인 | UMA + launchd 네이티브 상시 | Telegram 7×24 + macOS Skill 경로 |
팁: M4 통합 메모리는 Gateway, 브라우저 자동화, SQLite WAL이 고대역width 풀을 공유합니다. 커뮤니티 모니터링 기준 Gateway 상시 약 4 GB급이어도 16 GB 기종에 여유가 있습니다. 원격 임대 후 SSH로 동일 install 명령을 실행하면 됩니다.
~/.hermes/hermes-agent/, 전역 hermes는 install 스크립트가 PATH에 추가.hermes update.~/.hermes/skills/; 호스트 다운 시 복리 중단 — 「7×24 필수」와 직결.주말 실험이면 노트북 + 클라우드 API로 충분합니다. Hermes를 「매일 일거리를 받는 동료」로 쓰려면 뚜껑 슬립, VPS의 macOS 단절, 그룹 프라이버시 함정이 동시에 커집니다. Mac Mini 자가 구매도 가능하지만, 먼저 30일 월 임대로 워크플로를 검증한 뒤 구매 결정이 비용 최소 — 기종은 임대 요금 참조.
가정 Wi-Fi 단절, VPS 과매도, Raspberry Pi 디스크 I/O 포화는 Gateway를 중요한 순간에 끊습니다 — Telegram 사용자에게는 「Bot 또 죽었네」로 보입니다. 안정 7×24 Hermes와 macOS 네이티브 install·launchd 상시가 필요한 프로덕션에서는 NodeMini Mac Mini M4 클라우드 임대가 「타협 노트북 + 수동 재시작」보다 낫습니다. Agent 복리에 집중하고, 새벽 hermes gateway status 수리에서 벗어납니다.