Hermes 돌려보기
Hermes Agent v0.8.0 은 Linux, macOS, WSL2 에서 대략 60 초면 설치된다. curl 한 줄이면 설치 스크립트가 uv, Python 3.11, Node.js, ripgrep, ffmpeg 까지 다 챙긴다.
checklist 시스템 요구사항
사전 준비물은 git 뿐 — Python 3.11, Node.js v22, uv, ripgrep, ffmpeg 는 스크립트가 설치한다
Linux, macOS, Windows 의 WSL2, Termux 를 통한 Android. 네이티브 Windows 는 지원하지 않는다.
최소 2 GB RAM. 로컬 모델을 돌리면 더 필요하다
에이전트, venv, Node modules, 내장 스킬 합쳐서 약 1 GB
선택: 명령 실행을 샌드박싱할 Docker, SSH, Daytona, Singularity, Modal
호스팅 모델 API 는 인터넷 연결이 필요하다. OpenAI 호환 endpoint 로 도는 로컬 모델은 오프라인에서도 동작한다.
공식 문서의 한 줄 명령. Linux, macOS, WSL2 사용자 대부분에게 권장된다. 설치 문서 arrow_forward
WSL2(Windows)
네이티브 Windows 는 지원하지 않는다. 'wsl --install' 로 WSL2 를 깔고, WSL2 셸 안에서 이 명령을 실행한다.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash macOS / Linux / WSL2
사전 준비물은 git 뿐이다 — uv, Python 3.11, Node.js v22, ripgrep, ffmpeg 는 설치 스크립트가 알아서 깐다.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash verified 설치 확인
공식 문서에 있는 검증 명령을 실행한다.
hermes version 설치된 버전을 찍는다(0.8.0 이상이어야 한다).
hermes doctor 진단 실행 — Python, uv, 의존성, 설정 파일, 연결성까지 점검한다.
hermes status 현재 설정 상태를 찍는다: 모델 프로바이더, 활성화된 도구, 연결된 gateway.
settings 초기 설정
설치 후 셸을 다시 읽고, 문서에 나온 세 개의 설정 명령을 실행한다.
모델 프로바이더 선택
'hermes model' 을 실행해서 프로바이더를 고른다. README 에는 Nous Portal, OpenRouter, z.ai/GLM, Kimi/Moonshot, MiniMax, OpenAI, 커스텀 endpoint 가 나열되어 있다. Anthropic 과 Mistral 도 의존성으로 포함된다.
쓸 도구 활성화
'hermes tools' 를 실행해 내장된 47 개 도구 중 어떤 걸 쓸지 정한다. 나중에 얼마든지 추가하거나 뺄 수 있다.
전체 설정 마법사 실행
'hermes setup' 으로 전체 흐름을 돌려 API key 와 챗 gateway 연결(Telegram, Discord, Slack, WhatsApp, Signal, Email) 까지 끝낸다.
테스트 메시지 보내기
'hermes chat -q "Hello! What tools do you have available?"' 를 시도해 보자 — 공식 quickstart 에 그대로 나와 있다.
.env — 설정은 ~/.hermes/ 아래에 있다 — 메인 설정은 config.yaml, API key 는 .env, 그리고 session, logs, memories, skills, cron job 용 하위 디렉터리가 있다. 환경 변수 레퍼런스는 hermes-agent.nousresearch.com/docs/reference/environment-variables 를 보면 된다.
cloud VPS / 서버 배포
Hermes 는 2 GB 메모리, 약 1 GB 디스크의 Linux VPS 에서 실행된다. 같은 원라이너를 SSH 로 실행하면 된다.
서버에 SSH 로 접속
Ubuntu, Debian, CentOS, Arch 등 일반적인 배포판이면 된다.
ssh user@your-server-ip 설치 스크립트 실행
스크립트가 배포판을 자동 감지하고, uv 를 통해 Python 3.11 을 설치하며 모든 의존성을 세팅한다.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 샌드박스 백엔드 활성화
공유 인프라에서는 샌드박스 백엔드(Docker, SSH, Daytona, Singularity, Modal) 중 하나를 설정하여 Hermes 의 셸 명령을 격리 환경에서 실행하자. 자세한 설정은 README 참조.
API 키 설정 후 실행
모델 제공자를 선택하고 Hermes 를 실행한다. 프로세스가 포어그라운드에서 돌아가므로 tmux 나 screen 으로 유지하는 것을 권장한다.
hermes model && hermes Tip — 상주 데몬으로 쓰려면 tmux/screen 안에서 Hermes 를 실행하거나 systemd unit 파일을 작성하자. 공식 문서에 데몬 설정 예시가 있다.
system_update_alt Hermes 업그레이드
README 에 내장 업데이터인 'hermes update' 가 명시되어 있다. 공식 PyPI 패키지나 Docker image 는 없으므로 다른 업그레이드 경로는 git 으로 처리한다. 업그레이드 가이드 arrow_forward
hermes update cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]" curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash # 공식 Docker image 는 아직 없다 각 버전의 변경점은 github.com/NousResearch/hermes-agent/releases 에서 확인.
delete_forever Hermes 제거
Hermes 는 ~/.hermes/hermes-agent/ 에 설치되고 바이너리는 ~/.local/bin/hermes 에 심볼릭 링크된다. 두 개만 지우면 끝이다. 제거 관련 참고 arrow_forward
rm ~/.local/bin/hermes rm -rf ~/.hermes/hermes-agent rm -rf ~/.hermes/hermes-agent # 제거할 공식 Docker image 는 없음 사용자 데이터도 제거(선택)
세션, 기억, 스킬, cron job, API key 가 전부 지워진다. 필요한 건 먼저 백업하자.
rm -rf ~/.hermes # WSL 셸 안에서 실행 — 네이티브 Windows 는 지원하지 않는다 도움이 필요할 때
Nous Research Discord 에 오면 설치 관련 지원과 커뮤니티의 문제 해결 노하우를 얻을 수 있다.