2026년에 Nous Research 오픈소스 Hermes Agent를 검토 중이라면, 실제 장벽은 「Prompt 작성」이 아니라 설치 스크립트, Python/Node 의존성, LLM API Key, Telegram Bot과 Gateway 백그라운드 서비스라는 긴 공정 세부입니다. 본문은 macOS / Linux / WSL2에서 Hermes를 「동작」에서 「휴대폰으로 언제든 호출하고, 머신이 7×24 온라인」까지 끌어올리려는 개발자와 소규모 팀을 대상으로 합니다. 먼저 여섯 가지 설치 오해를 풀고, 환경 대조표와 호스트 매트릭스를 제시한 뒤, 복제 가능한 curl | bash, hermes doctor, hermes setup, Telegram Gateway 절차(8단계 이상)를 안내합니다. 기억 아키텍처와 구매 vs 대여 TCO는 사이트 3계층 메모리 전문과 24개월 TCO 글을 참고하세요. 월 요금은 NOVAKVM 대여 가격 페이지, 주문은 주문 페이지입니다. 아래 명령과 버전은 공식 문서를 정본으로 삼고, 릴리스 후 링크를 다시 열어 확인하십시오.
[ SECTION_01 ] // PAIN_MAP Hermes Agent 설치 시 가장 흔한 여섯 가지 오해(2026)
- 「Python 3.11과 Node 22를 먼저 직접 설치해야 한다」: 공식 설치 스크립트가
uv로 런타임을 맞춥니다. Git만 사용 가능하면 됩니다. 시스템 Python을 수동 혼용하면ModuleNotFoundError가 자주 납니다. - 「설치하면 바로 Telegram에서 대화할 수 있다」: CLI 대화와 Gateway는 별 경로입니다. 채널은
hermes gateway setup과 데몬 기동을 따로 해야 합니다. - 「hermes: command not found는 설치 실패」: 대부분 PATH 미반영입니다. 새 터미널을 열거나
source ~/.zshrc로 해결하며, 전체 재설치는 필요 없습니다. - 「아무 Linux VPS나 Mac과 동등하다」: 문서는 macOS에서 경로가 가장 완전합니다. 일부 브라우저 자동화와 macOS 전용 Skill은 순수 Linux에서 동작이 다릅니다. 프로덕션 전 공식 플랫폼 설명을 대조하세요.
- 「그룹에서 @Bot 했는데 응답이 없다」: Telegram 프라이버시 모드에서는 그룹이
/명령만 응답합니다. BotFather에서 Group Privacy를 끄고 Bot을 내보낸 뒤 다시 초대해야 합니다. - 「노트북 덮개를 닫아도 프로덕션 Gateway가 된다」: 절전 시 프로세스가 멈춥니다. Skill 복리와 채널 콜백에는 감시된 상시 가동 호스트가 필요하며, 「설치 가능」과는 별개입니다.
아래는 Hermes 공식 진입점입니다. 릴리스마다 설치기 URL과 인자를 다시 확인하십시오.
Hermes Agent 공식 설치 문서(Nous Research)
NousResearch/hermes-agent(GitHub 저장소)
[ SECTION_02 ] // ENV_MATRIX Hermes Agent 환경 요건: 최소 구성과 배포 호스트 선택
아래 표는 로컬 설치의 실무 하한을 요약합니다. Gateway가 클라우드 API만 쓰면 메모리 부담은 「동일 머신 로컬 대형 모델」보다 낮습니다. 금액과 재고는 표에 없습니다. 대여 가격 페이지에서 확인하세요.
| 항목 | 최소 | 권장(프로덕션 Gateway) |
|---|---|---|
| OS | macOS 12+, Ubuntu 20.04+, WSL2 | macOS 14+(Apple Silicon) 또는 Ubuntu 24.04 LTS |
| 메모리 | 4 GB(API + Gateway만) | 16 GB. 로컬 Ollama나 큰 Skill 트리는 24–32 GB 검토 |
| 디스크 | 약 1.5 GB(Skills 캐시 포함) | 20 GB+ SSD. ~/.hermes/ 증가 여유 확보 |
| 네트워크 | GitHub raw와 LLM API 접근 가능 | 안정적 저지연 egress. Telegram 콜백에 유리 |
| 전제 의존성 | Git 2.30+ | 스크립트가 Python 3.11, Node 22, ripgrep, ffmpeg 자동 설치 |
| 호스트 | 설치 난이도 | 7×24 Gateway | 전형적 이슈 |
|---|---|---|---|
| 개인 MacBook | 낮음(curl만) | 덮개 닫으면 끊김. POC 적합 | 개인 데이터와 Agent 기억 혼재 |
| 범용 Linux VPS | 중간(--skip-browser 가능) |
가동률은 높으나 RTT가 도구 루프를 느리게 함 | macOS 네이티브 브라우저 자동화 경로 부재 |
| NOVAKVM 월간 Mac mini M4 | 낮음(문서 주 경로와 일치) | 독점 베어메탈, launchd 데몬 | SSH와 ~/.hermes/ 백업 설계 필요 |
설치만 검증한다면 노트북으로 충분합니다. Telegram + Skill 복리를 수 주 이어가려면 Gateway를 절전하지 않는 프로덕션 Mac에 두십시오.
[ SECTION_03 ] // INSTALL Hermes Agent 원클릭 설치: curl 스크립트, PATH, hermes doctor
macOS, Linux, WSL2, Termux에서는 공식 권장 한 줄 설치(저장소는 ~/.hermes/hermes-agent/, 전역 hermes 명령 등록)를 사용합니다.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes doctor
hermes --version헤드리스 서버에서 브라우저 자동화가 불필요하면 관련 의존성을 건너뛸 수 있습니다(인자는 공식 문서를 정본으로 합니다).
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browserhermes doctor는 Python, Node, ripgrep, ffmpeg, PATH, API Key 등을 자가 진단합니다. 실패 항목이 나오면 안내에 따라 수정하고 건너뛰지 마십시오. Windows 네이티브 PowerShell 설치기는 초기 Beta입니다. 프로덕션에서는 WSL2 + 위 Linux 명령이 더 안정적입니다(공식 Installation 장 참조).
[ SECTION_04 ] // RUNBOOK 8단계로 Hermes 통과: 모델, CLI 스모크, Telegram과 Gateway 상시 운영
- 설치 완료와 PATH 갱신:
~/.hermes디렉터리 확인 후hermes doctor를 실행해 차단 항목이 없는지 확인합니다. - LLM 설정: 처음이면
hermes setup. 기존 Key는hermes model또는~/.hermes/.env(OpenRouter, Anthropic, OpenAI, Ollama Base URL 등)에 기록합니다. - CLI 스모크:
hermes를 실행하고 실제 작업(예: 「현재 디렉터리 파일 유형 분포 요약」)으로 툴체인과 API 과금을 확인합니다. - Telegram Bot 생성: Telegram에서
@BotFather를 열고/newbot으로 Token을 받습니다.@userinfobot으로 본인 숫자 ID를 확인합니다. - Gateway 설정:
hermes gateway setup에서 Telegram 선택을 권장합니다. 수동이면TELEGRAM_BOT_TOKEN과TELEGRAM_ALLOWED_USERS를 설정합니다. - Gateway 전경 검증:
hermes gateway를 실행하고 휴대폰 Bot 개인 채팅으로 메시지를 보내 응답을 확인한 뒤 백그라운드로 전환합니다. - 데몬 설치: macOS는
hermes gateway install+hermes gateway start(launchd). Linux는sudo hermes gateway install --system을 선택하고journalctl -u hermes-gateway -f로 로그를 봅니다. - 백업과 이전 규율:
~/.hermes/를 정기 아카이브합니다. 교체·해지 전에는 디렉터리 단위 복원하고, 바이너리만 재설치해 「기억 상실」을 만들지 마십시오.
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway statusTelegram 그룹 사용 시 공식 Messaging 문서의 프라이버시 모드 설명을 반드시 읽으십시오. Group Privacy를 끈 뒤 Bot을 그룹에서 내보내고 다시 초대해야 합니다.
Hermes Agent Telegram 연동 문서(GitHub)
[ SECTION_05 ] // TROUBLESHOOT Hermes Agent 설치와 Gateway 흔한 오류
| 현상 | 흔한 원인 | 조치 방향 |
|---|---|---|
hermes: command not found |
PATH 미로드 | source ~/.zshrc 또는 새 터미널 |
| API key not set | 프로바이더 미설정 | hermes model 또는 ~/.hermes/.env 편집 |
| Missing config after update | 버전 업그레이드 설정 어긋남 | hermes config check와 hermes config migrate |
| ModuleNotFoundError: dotenv | 시스템 Python 오사용 | ~/.hermes/hermes-agent/venv 내부 바이너리 호출 |
| Telegram 그룹 무응답 | 프라이버시 모드 / 재초대 미실시 | BotFather에서 Group Privacy 끈 뒤 내보내고 재초대 |
원격 Mac에서 위 절차를 실행한다면 연결과 세션 안전 기준은 고객 센터를 참고하십시오. 독점 Apple Silicon과 명확한 해지 삭제가 필요하면 개인 노트북 장기 점유보다 월간 베어메탈을 우선 검토하세요.
[ SECTION_06 ] // HARD_FACTS 인용 가능한 기술 정보와 NOVAKVM 정리
- 설치기 동작: 공식 스크립트는
uv로 Python 3.11, Node 22, ripgrep, ffmpeg를 설치하고 저장소를~/.hermes/hermes-agent/에 둡니다.(출처: Installation 문서. 릴리스 후 재확인.) - 설정 루트: 환경 변수와 Gateway 토큰은 기본
~/.hermes/.env. 세션 간 기억과 Skill도 같은 트리에 영속화합니다.(출처: 공식 Memory / Setup 문서.) - 모델 비종속: Hermes는 Anthropic, OpenAI, OpenRouter, GitHub Copilot, Ollama 등에 연결 가능합니다. 모델 ID와 과금은 각 프로바이더 페이지를 정본으로 합니다.
- MCP 확장:
~/.hermes/config.yaml에mcp_servers를 선언하고hermes mcp login으로 OAuth 완료(headless에서는 SSH 터널과 자주 병행). - 버전 확인:
hermes --version과 GitHub Releases를 정본으로 합니다. 2차 정보의 Star 수나 출처 불명 성능 순위는 옮기지 마십시오.
「설치 성공」을 출발점으로 삼으십시오. 개인 노트북은 주말 POC에 적합하지만 절전, OS 업데이트, 개인 데이터 혼재로 Gateway와 Skill 복리가 자주 끊깁니다. 순수 Linux VPS는 API 경로를 통과하지만 브라우저 자동화와 macOS 툴체인에서 한 단계 손실이 날 수 있습니다. CLI에서 Hermes 장기 가치를 확인했다면 더 실무적인 프로덕션 경로는 먼저 월간 독점 Mac mini M4로 2–4주 Gateway 로그를 쌓고 자가 구매를 판단하는 것입니다.
NOVAKVM 대여 가격 페이지에서 동시 실행과 디스크를 고르고, 주문 페이지에서 노드를 올린 뒤 본문 8단계로 설치와 Telegram 상시 운영을 완료하십시오. 네이티브 macOS 설치 경로, 7×24 launchd 데몬, 예측 가능한 해지 삭제가 필요한 Hermes 프로덕션 환경에서는 NOVAKVM Mac mini 클라우드 베어메탈 대여가 주력 노트북을 7×24 켜 두는 것보다 의사결정 비용이 낮은 경우가 많습니다.