업데이트와 제거
기준일: 2026-07-26
문서 반영 버전: v2026.7.20
난이도: 초급
공식 기준: Updating, Installation, GitHub Releases
Hermes는 hermes update 한 줄로 갱신할 수 있지만, 게이트웨이와 세션을 운영 중이라면 업데이트 전후 확인 순서가 중요합니다.
핵심 개념
| 항목 | 의미 |
|---|---|
hermes update |
git pull + deps + config migrate + gateway 재시작 |
| pre-update snapshot | pairing, cron, config, .env, auth 등 상태 스냅샷 (기본 quick) |
| config 보존 | ~/.hermes/config.yaml과 ~/.hermes/.env는 데이터 홈에 유지 |
| auto-rollback | pull 후 핵심 파일 구문 오류 시 pre-pull SHA로 hard reset |
| doctor | 설치/의존성/권한 문제를 먼저 좁히는 진단 명령 |
| install method detection | git / Docker / Nix 경로를 자동 감지해 맞는 업데이트 안내 |
update가 하는 일 (공식 순서)
- Pre-update snapshot (
updates.pre_update_backup:quick|full|off) - Git pull (
main또는--branch) - Post-pull syntax validation + 실패 시 auto-rollback
uv pip install -e ".[all]"- Config migration 프롬프트
- 실행 중 gateway 자동 재시작 (systemd/launchd 또는 profile PID 매핑)
선택 기준
- 단순 CLI 사용자:
hermes update후hermes doctor/hermes version - 게이트웨이 운영: 업데이트 전
hermes gateway status, 후 상태·실제 메시지 테스트 - 프로덕션 프로필:
hermes update --backup또는pre_update_backup: full - 먼저 미리보기만:
hermes update --check(파일 변경 없음)
실습
hermes version
hermes update --check
hermes doctor
hermes update
hermes doctor
hermes version
전체 백업 옵션:
hermes update --backup
# ~/.hermes/config.yaml
updates:
pre_update_backup: quick # quick | full | off
non_interactive_local_changes: stash # stash | discard (앱/비대화형)
게이트웨이:
hermes gateway status
# update 후 자동 재시작이 일반적
hermes gateway status
메시징에서:
/update
(재시작 중 5–15초 정도 오프라인될 수 있음)
수동 설치 경로:
cd ~/.hermes/hermes-agent # 또는 소스 경로
git pull origin main
uv pip install -e ".[all]"
hermes config check
hermes config migrate
롤백 (이전 태그 예시 — 실제 태그는 git tag로 확인):
cd ~/.hermes/hermes-agent
git checkout v2026.7.1
uv pip install -e ".[all]"
hermes gateway restart
hermes config check
Windows에서는 다른 hermes.exe(Desktop, REPL, gateway)가 실행 중이면 update가 거부될 수 있습니다. Desktop/REPL/gateway를 종료한 뒤 재시도합니다.
업데이트 로그:
tail -f ~/.hermes/logs/update.log
제거:
hermes uninstall
# 또는 수동
# rm -f ~/.local/bin/hermes
# rm -rf ~/.hermes/hermes-agent
# rm -rf ~/.hermes # 설정까지 삭제할 때만
Hermes에 입력할 프롬프트
내 Hermes 업데이트 전 점검표를 만들어줘.
CLI만 쓰는 경우와 gateway를 운영하는 경우를 분리하고,
업데이트 후 반드시 확인할 명령과 실패 시 복구 순서를 제안해줘.
체크리스트
- 업데이트 전 현재 버전과 provider 설정을 기록했다.
- 필요하면
hermes update --check/--backup을 사용했다. -
config.yaml과.env가 무엇을 보존하는지 이해했다. - gateway 운영 중이면 재시작과 실제 메시지 수신을 확인했다.
- 문제 발생 시
doctor → model → setup → gateway status순서로 좁힌다. - 최신 변경은 변경 이력과 GitHub releases로 대조한다.
다음 단계
- 변경 이력에서 최근 릴리즈 포인트를 봅니다.
- Provider와 모델 설정에서 모델 연결을 다시 확인합니다.
- 트러블슈팅에서 깨진 설치와 게이트웨이를 복구합니다.