업데이트와 제거

기준일: 2026-06-06
난이도: 초급
공식 기준: Updating, Installation

Hermes는 설치 스크립트 기반으로 빠르게 갱신할 수 있지만, 게이트웨이와 세션을 운영 중이라면 업데이트 전후 확인 순서가 중요합니다.

핵심 개념

선택 기준

• 단순 CLI 사용자라면 hermes update 또는 공식 설치 스크립트 재실행 후 hermes doctor를 확인합니다.
• 게이트웨이를 운영한다면 업데이트 전 hermes gateway status, 후 hermes gateway restart와 실제 메시지 테스트를 함께 수행합니다.
• 설정을 크게 바꿨다면 업데이트 문제가 아니라 provider/model 설정 문제일 수 있으므로 hermes model을 먼저 재검증합니다.

실습

hermes --version
hermes doctor
hermes update
hermes doctor

게이트웨이를 쓰는 경우:

hermes gateway status
hermes gateway restart
hermes gateway status

Hermes에 입력할 프롬프트

내 Hermes 업데이트 전 점검표를 만들어줘.
CLI만 쓰는 경우와 gateway를 운영하는 경우를 분리하고,
업데이트 후 반드시 확인할 명령과 실패 시 복구 순서를 제안해줘.

체크리스트

• 업데이트 전 현재 버전과 provider 설정을 기록했다.
• config.yaml과 .env가 무엇을 보존하는지 이해했다.
• gateway 운영 중이면 재시작과 실제 메시지 수신을 확인했다.
• 문제 발생 시 doctor -> model -> setup -> gateway status 순서로 좁힌다.

다음 단계

• Provider와 모델 설정에서 모델 연결을 다시 확인합니다.
• 트러블슈팅에서 깨진 설치와 게이트웨이를 복구합니다.