Hermes Agent 설치
기준일: 2026-06-06
난이도: 초급
공식 기준: Installation
Hermes Agent는 Desktop 설치와 CLI 전용 설치를 모두 제공합니다. 일반 사용자는 Desktop 설치가 가장 단순하고, 서버/터미널 중심 사용자는 CLI 설치가 적합합니다.
핵심 개념
설치가 만드는 것은 단순한 바이너리 하나가 아닙니다.
| 항목 | 기본 위치 또는 역할 |
|---|---|
hermes 명령 |
CLI 실행 진입점 |
~/.hermes/ |
설정, 세션, 메모리, 스킬 데이터 |
| Hermes Agent 코드 | 일반적으로 ~/.hermes/hermes-agent/ |
| 의존성 | Python 3.11, Node.js 22, ripgrep, ffmpeg 등 |
공식 설치 스크립트는 Git만 있으면 나머지 의존성을 자동으로 준비합니다. Windows native는 지원하지만, 프로젝트가 Linux 도구체인에 강하게 묶여 있으면 WSL2가 더 예측 가능합니다.
선택 기준
| 설치 방식 | 추천 상황 | 주의점 |
|---|---|---|
| Desktop installer | GUI와 CLI를 함께 쓰려는 일반 사용자 | 조직 배포 정책 확인 |
| CLI installer | 터미널 중심 개인 환경 | 설치 후 shell reload 필요 |
| WSL2 | Windows에서 Linux 프로젝트를 다룸 | Windows native 데이터와 분리 |
| Source install | 기여, 특정 브랜치 검증 | 업데이트/의존성 관리 필요 |
실습
macOS, Linux, WSL2, Termux:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc # zsh 사용 시
hermes --help
Windows PowerShell:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
hermes --help
Desktop 설치 후 CLI만 따로 쓰고 싶다면:
hermes desktop
설치 후 바로 모델까지 연결하려면:
hermes setup --portal
hermes portal info
Hermes에 입력할 프롬프트
내 Hermes 설치 상태를 점검해줘.
hermes 명령, 설정 디렉터리, 모델 provider, 활성 toolset을 확인하고
문제가 있으면 재현 명령과 해결 순서를 분리해서 알려줘.
체크리스트
-
git --version이 동작한다. -
hermes --help가 출력된다. -
~/.hermes/데이터 위치를 확인했다. - Desktop, CLI, WSL2 중 어떤 경로로 운영할지 정했다.
- 설치 로그에 실패한 의존성이 없는지 확인했다.
다음 단계
- 빠른 시작에서 첫 대화를 시작합니다.
- Provider와 모델 설정에서 모델 구성을 확인합니다.
- 트러블슈팅에서 설치 문제를 분리합니다.