macOS / Linux 원라인 · hermes doctor · LLM 설정 · Gateway 7×24 · 원격 Mac 검수
이런 분께: 2026년 6월 기준 GitHub 스타 약 17만의 Nous Research Hermes Agent를 쓰고 싶은데 CLI·LLM·Telegram 어딘가에서 멈춤 — PATH 미반영, API Key 미설정, Gateway는 online인데 그룹에서 무응답.결론: 공식 curl | bash → hermes doctor → ~/.hermes/.env LLM → hermes gateway install로 7×24.7×24 Mac이 필요한 이유와 함께 Mac mini M4 월 임대를 검토하세요.구성: 요구 사항 → 설치 → doctor/LLM → Telegram → Skill → 오류 표 → 플랫폼 → FAQ.
Hermes Agent는 Nous Research가 MIT 라이선스로 공개한 「자기 진화형」 AI 에이전트입니다. 작업이 성공하면 실행 경로를 ~/.hermes/skills/ 아래 재사용 가능한 Skill로 저장합니다. 2026년 초 커뮤니티 벤치마크에 따르면 Skill 라이브러리가 커질수록(예: 30일 일일 사용 시 3개→19개) 반복 워크플로의 토큰 사용량이 약 38% 줄어듭니다. Gateway 프로세스가 Telegram·Discord·Slack·WhatsApp 등 20개 이상 채널에 연결되고, MCP 서버로 코어 저장소를 포크하지 않고 도구를 확장합니다.
이 사이트에서 자주 다루는 OpenClaw(IM 연동 사례가 풍부)나 직접 조립하는 CrewAI / LangGraph와 달리, Hermes는 CLI·doctor·채널 어댑터·기억 파일(SESSION → MEMORY.md → USER.md)까지 갖춘 설치형 제품입니다. 3층 기억과 Mac mini 임대 글을 읽었다면, 본문은 설치·검증·데몬 상시 구동 실무편으로 보시면 됩니다.
2026년 6월 기준 지원 티켓은 대개 세 가지입니다. 설치 스크립트가 Python·Node를 정말 포함하는지, Gateway가 launchd/systemd로 재부팅 후에도 살아 있는지, Telegram 그룹 프라이버시 때문에 일반 메시지가 무시되는지입니다. README 붙여넣기가 아니라 실제 티켓 순서로 정리합니다. 공식 문서: hermes-agent.nousresearch.com/docs/getting-started/installation, 버전 확인: github.com/NousResearch/hermes-agent.
과대 평가된 전제: Python 3.11·Node 22·ripgrep·ffmpeg를 수동 설치해야 한다고 생각하지만, 공식 스크립트가 처리합니다.
LLM 미설정: hermes setup이나 ~/.hermes/.env를 건너뛰면 CLI는 뜨지만 추론이 실패합니다.
Gateway가 전경만: SSH를 끊으면 Telegram이 죽습니다. hermes gateway install 미실행이 전형입니다.
그룹 프라이버시: BotFather에서 끄고 봇을 재초대하기 전까지 그룹에서는 / 명령만 보입니다.
설치 프로그램이 OS를 검사하고 의존성을 가져옵니다. 아래 표로 이 머신이 충분한지, 클라우드 API만 쓸지 로컬 모델까지 할지 판단하세요.
한국 스타트업·1인 개발 환경에서는 4GB x86 VPS에 Ollama와 브라우저 자동화를 동시에 올렸다가 Telegram long polling이 끊기는 사례가 많습니다. hermes doctor를 돌리기 전에 RAM을 잡아 두면, 본번 첫날 밤에 swap 지옥을 피할 수 있습니다. Gateway만 쓸 계획이면 4GB도 가능하지만, Skill 검색·로컬 모델·MCP를 겹치면 16GB를 기본선으로 두는 편이 안전합니다.
| 항목 | 최소 | 권장 |
|---|---|---|
| OS | macOS 12+, Ubuntu 20.04+, WSL2 | macOS 14+ (Apple Silicon) / Ubuntu 24.04 LTS |
| Python / Node | Installer provides 3.11 / Node 18+ | Installer defaults to Node 22; no sudo required |
| 메모리 | 4 GB (Gateway + cloud APIs only) | 16 GB (Ollama or browser automation) |
| 디스크 | ~1.5 GB including Skill cache | 20 GB+ SSD if storing local model weights |
| 네트워크 | GitHub raw + LLM API reachability | Stable low-latency egress for Telegram long polling |
기억할 세 가지: (1) 표준 설치에 Python·Node·ripgrep·ffmpeg 수동 설치는 불필요합니다. (2) GUI 없는 Linux VPS는 --skip-browser를 붙입니다. (3) Windows 네이티브는 베타 — 대부분 WSL2 + Linux 설치 스크립트가 지원 경로입니다.
평가 기간에는 집 MacBook보다 VNCMac 물리 Mac mini M4 월 임대가 Telegram 본번에 유리합니다. 전기·장애·회선 품질을 직접 부담하지 않고 launchd 상시 구동을 유지할 수 있습니다. 원격 노드를 먼저 빌린 뒤 Hermes를 설치하고, 하드웨어 구매는 검증 후에 결정하세요.
터미널에서 main 브랜치 공식 스크립트를 실행합니다(본번 전 Nous 문서에서 URL 재확인):
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
스크립트 흐름: uv → Python 3.11 → Node.js 22 → ripgrep·ffmpeg → ~/.hermes/hermes-agent/ 클론 → 전역 hermes → 기본 Skill 레지스트리. 성공 시 설치 출력에 ✅ Hermes Agent installed at ~/.hermes.
PATH 반영: macOS는 source ~/.zshrc, Linux는 source ~/.bashrc.
GUI 없는 서버: curl -fsSL .../install.sh | bash -s -- --skip-browser.
hermes doctor로 헬스 체크 통과(4절).
LLM 연결: hermes setup(4절 표).
임대 원격 Mac 첫 설치는 화면 녹화·손쉬운 사용 권한 TCC가 뜨면 VNC로 — SSH만으로는 「허용」 클릭 불가.
Windows: iex (irm .../install.ps1), 경로 %LOCALAPPDATA%\hermes\. 대시보드 터미널은 Unix 셸이 필요하면 WSL2. Android Termux도 동일 curl | bash와 환경 감지.
VNC 로그인 → 터미널 → 설치 → hermes doctor 스크린샷 → hermes setup로 API → 이후 SSH 운영. ~/.hermes/에 Skill·SQLite·.env. 반납 전 tar czf hermes-backup.tgz ~/.hermes로 다음 노드에 복원.
macOS는 화면 녹화·손쉬운 사용·자동화(TCC) 권한을 처음 한 번 그래픽 세션에서 허용해야 합니다. SSH만으로는 「허용」 버튼을 누를 수 없어, VNCMac 노드에서는 첫 설치·첫 Gateway 검수는 VNC, 일상 운영은 SSH로 나누는 패턴이 가장 재현성이 높습니다. OpenClaw 원격 Mac 가이드와 동일한 운영 습관입니다.
hermes doctor hermes --version hermes setup # 전체 마법사, 첫 실행 권장 # or: hermes model
hermes doctor는 검수 관문입니다. virtualenv·CLI shim·설정·브라우저 스택·채널 전제를 확인합니다. Telegram 트래픽을 붙이기 전 CI처럼 통과시키세요.
| 제공자 | 특징 | 설정 |
|---|---|---|
| Nous Portal | 구독 경로, 300+ 모델 | hermes setup --portal (OAuth) |
| OpenRouter | 다중 모델 실험 | ~/.hermes/.env에 API 키 |
| Anthropic / OpenAI | Claude / GPT 계열 | 마법사로 API 키 또는 OAuth |
| Ollama / vLLM | 로컬 추론 | Base URL + 키, RAM 16GB+ 권장 |
마법사 대신 파일: hermes config set OPENROUTER_API_KEY sk-or-xxxx 또는 ~/.hermes/.env에 추가. hermes 대화로 「오늘 AI 헤드라인 요약」 등 스모크 테스트, 401 없는지 확인.
두 번째 요약: Gateway 설치 전 doctor 통과; 버전 문자열은 지원 스레드에 유용; 8GB에서 Ollama는 Skill 동시 검색 시 스왑 — 기억 글의 16GB 하한 / 24GB 여유에 맞추세요.
Telegram에서 @BotFather, /newbot, 토큰 안전 보관.
@userinfobot 등으로 숫자 User ID 확인.
hermes gateway setup에서 Telegram, 토큰·ID — 또는 .env에 TELEGRAM_BOT_TOKEN·TELEGRAM_ALLOWED_USERS.
hermes gateway 전경 실행 후 휴대폰 DM 테스트.
본번: hermes gateway install && hermes gateway start. macOS launchd; Linux는 sudo hermes gateway install --system.
그룹 채팅: 기본 프라이버시 모드에서는 슬래시 명령만 보입니다. BotFather에서 Group Privacy 끄고, 봇을보낸 뒤 다시 초대하세요.
15분 검수: (1) DM 응답 (2) hermes gateway status running (3) 재부팅 후 자동 기동 (4) 반복 401/429 없음. Linux journalctl -u hermes-gateway -f; 임대 Mac은 VNC에서 콘솔 hermes 필터.
| 명령 | 용도 |
|---|---|
| hermes | 대화형 CLI |
| hermes tools | 도구 표면 on/off |
| hermes gateway status | 데몬 상태 |
| hermes update | 최신 릴리스 |
| hermes config check | 업그레이드 후 설정 검증 |
Skill 진화는 호스트가 온라인일 때만 복리가 납니다. 성공 실행은 ~/.hermes/skills/의 절차가 됩니다. MacBook을 매일 슬립하면 디스크에 파일이 있어도 복리가 멈춥니다.
~/.hermes/config.yaml의 mcp_servers에 MCP 선언(예: GitHub). 최소 권한 토큰. 브라우저 MCP는 macOS가 가장 완전; headless Linux는 의존성 누락 — POC 후 Mac mini로 Gateway 이전하는 이유입니다.
| 증상 | 원인 | 조치 |
|---|---|---|
| hermes: command not found | PATH 미반영 | source ~/.zshrc or new terminal |
| API key not set | LLM 미설정 | hermes model or edit .env |
| Missing config after update | 업그레이드 스키마 드리프트 | hermes config migrate |
| ModuleNotFoundError: dotenv | 잘못된 Python | Use ~/.hermes/.../venv/bin/hermes |
| Telegram group silence | 프라이버시 모드 | BotFather 끄기 + 재초대 |
| 플랫폼 | 7×24 | Skill 복리 | 적합 |
|---|---|---|---|
| 개인 MacBook | ~60%(슬립 시 Gateway 중단) | 중단 | 주말 POC만 |
| x86 VPS(4GB) | 가동률 ~99.5% | 안정, macOS 전용 도구 없음 | Linux 전용 운영 |
| Mac mini M4 임대 | 데이터센터 SLA | launchd + 통합 메모리 | Telegram 본번 사용자 |
Mac mini M4 16GB 신품은 2026년 6월 미국 기준 약 $599–$699(예산 전 확인). 24개월 상각 시 월 $25–$30에 전기·냉각·장애 리스크가 추가됩니다. VNCMac 월 $195.9대는 CapEx를 OpEx로 바꿔 Hermes가 하루 2시간을 절약하는지 검증할 때 유리합니다. 통합 메모리는 Gateway(~4.2GB)·브라우저 CDP·SQLite WAL을 한 풀에 — 4GB x86 VPS는 Skill FTS 유지 중 스왑이 잦습니다.
내부 덱용 세 번째 수치: GitHub 스타 ~17만(2026년 6월), Skill 벤치마크 반복 작업 토큰 ~38% 절감, 본번 선언 전 doctor 12항목+, Telegram 검수 15분. 운영 Runbook에는 doctor 스크린샷과 gateway status 출력을 함께 보관해 두면 장애 시 원인 분리가 빨라집니다.
아니요. 공식 install.sh가 uv로 Python 3.11·Node 22·ripgrep·ffmpeg를 설치하고 hermes CLI를 등록합니다.
설치·Gateway 대부분은 SSH로 됩니다. 최초 macOS 프라이버시·일부 OAuth 브라우저 콜백은 VNC가 필요합니다 — OpenClaw 원격 Mac 가이드와 동일.
진입점은 공식 install 스크립트 동일. hermes update로 업그레이드; 설정 드리프트 시 hermes config check && hermes config migrate.
기억 아키텍처 글은 SOUL·Skill·SQLite에 7×24 디스크가 왜 필요한지 설명합니다. 본문은 설치·채널 배선. 먼저 설치, 그다음 호스트 등급.
Yes on separate directories and ports. Budget RAM accordingly—see our multi-agent on one rented Mini article for isolation patterns.
Hermes 설치는 일부러 단순합니다: 공식 스크립트 하나, hermes doctor 하나, .env 하나, Gateway 서비스 하나. 데모와 본번의 차이는 가동 시간 — Skill 복리·Telegram·기억 파일은 머신과 데몬이 살아 있을 때만 쌓입니다.
슬립 노트북·불안정한 가정 Wi‑Fi·피크에 제한되는 $5 VPS는 「시간이 지날수록 똑똑해짐」을 「매주 신입」으로 바꿉니다. 연간 부하가 측정되면 Mac mini M4 구매가 맞습니다. 아직 검증 중이면 물리 M4를 임대하고 SSH로 설치·VNC로 권한·임대 종료 전 ~/.hermes/ tarball 하세요.
Hermes를 설치하는 것이 1단계, 계속 돌리는 것이 제품입니다. Gateway와 Skill에 퇴근하지 않는 macOS가 필요하면 Mac mini M4 월 요금을 확인하세요.