Keep Hermes Fresh: Updating & Uninstalling Made Simple

Hermes를 최신 상태로 유지하기: 업데이트 & 삭제, 이렇게 간단합니다

AI 어시스턴트를 최신 상태로 유지하는 것이 로켓 과학처럼 느껴져서는 안 됩니다. 그래서 Hermes Agent는 이 모든 것을 단 하나의 명령어로 처리합니다. 업데이트에 대해 알아야 할 모든 것과, 완전한 확신을 가지고 업데이트할 수 있도록 백그라운드에서 어떤 일이 일어나는지 함께 살펴보겠습니다.

원커맨드 업데이트

Hermes 업데이트는 정말 간단합니다:

hermes update

끝입니다. 이 단일 명령어는 최신 코드를 가져오고, 모든 의존성을 업데이트하며, 마지막 업데이트 이후 추가된 새로운 구성 옵션에 대해서도 물어봅니다. 릴리스 노트를 뒤질 필요도, 수동 단계를 거칠 필요도 없습니다. 그저 깔끔한 명령어 하나면 충분합니다.

업데이트 중에는 실제로 무슨 일이 일어날까요?

“내부적으로 실제로 무슨 일이 벌어지는 걸까?” 궁금하실 수 있습니다. Hermes가 여러분을 최신 상태로 유지하기 위해 수행하는 6단계를 친절하게 설명해 드리겠습니다:

업데이트 전 스냅샷 — 어떤 변경이 있기 전에, Hermes는 중요한 상태 파일(페어링 데이터, cron 작업, 구성 등)의 가벼운 스냅샷을 저장합니다. 1GiB가 넘는 파일은 건너뛰므로 거대한 데이터베이스가 속도를 늦추는 일은 없습니다. 이 스냅샷은 설치된 모든 프로필에 대해 생성되어 안전망을 제공합니다.
Git pull — Hermes는 main 브랜치에서 최신 코드를 가져오고 서브모듈도 업데이트합니다.
풀 후 구문 검증 + 자동 롤백 — 여기가 핵심입니다. 코드를 가져온 후, Hermes는 9개의 중요한 파일이 모두 여전히 올바르게 구문 분석되는지 확인합니다. 만약 문제가 있어 보이는 것(예: 병합 충돌 마커)이 있으면, 자동으로 이전 버전으로 롤백하여 셸이 부팅 가능한 상태를 유지합니다. 업스트림에서 수정 사항이 반영되면 업데이트를 다시 실행하기만 하면 됩니다.
의존성 설치 — 새로 추가되거나 변경된 의존성이 자동으로 설치됩니다.
구성 마이그레이션 — Hermes는 새로운 구성 옵션을 감지하여 설정하도록 안내합니다. 프롬프트를 놓치셨나요? 걱정 마세요. hermes config check를 실행하여 누락된 항목을 확인한 다음, hermes config migrate를 실행하여 대화형으로 추가하면 됩니다.
게이트웨이 자동 재시작 — 실행 중인 게이트웨이가 새로고침되어 새 코드가 즉시 적용됩니다. 서비스로 관리되는 게이트웨이는 시스템 서비스 관리자를 통해 재시작되고, 수동으로 실행한 게이트웨이는 자동으로 다시 시작됩니다.

다른 브랜치에서 업데이트하기

때로는 릴리스 후보나 기능 브랜치를 테스트하고 싶을 수 있습니다. Hermes가 해결해 드립니다:

hermes update --branch release-candidate
hermes update --check --branch experimental   # 현재 얼마나 뒤처져 있는지 미리 확인만 하기

로컬 체크아웃이 다른 브랜치에 있는 경우, Hermes는 커밋되지 않은 작업을 자동으로 스태시하고, 대상 브랜치로 전환한 후 풀을 수행합니다. 로컬에 존재하지 않는 브랜치는 원격에서 자동으로 추적됩니다. 그리고 브랜치가 어디에도 존재하지 않는다면? Hermes는 깔끔하게 실패 처리하고 스태시된 변경 사항을 복원합니다. 절대 난처한 상황에 빠지지 않습니다.

기능 브랜치에 머물러 있다면?

기능 브랜치에 머물러 있는 상황이라면? Hermes는 우아하게 처리합니다:

완전히 병합된 브랜치 — Hermes는 main 브랜치로 전환하고 정확히 무슨 일이 있었는지 알려줍니다.
병합되지 않은 커밋, 깨끗한 작업 트리 — 업데이트는 여전히 main으로 진행됩니다(데스크톱 버튼과 같은 비대화형 업데이트에 중요). 하지만 커밋은 건드리지 않습니다. Hermes는 브랜치 이름과 돌아가는 방법을 알려주는 큰 안내 문구를 출력합니다.
더티 트리(커밋되지 않은 변경 사항) — Hermes는 여러분의 작업을 건드리지 않습니다. 업데이트는 SKIPPED로 표시되고 명확한 경고와 함께 해결 방법에 대한 정확한 명령어가 제공됩니다.

의도적으로 커스텀 브랜치를 유지 관리하는 경우, config.yaml에 updates.parked_branch_strategy: update_in_place를 설정하세요. 그러면 Hermes는 브랜치를 전환하는 대신 origin/main을 여러분의 브랜치로 병합합니다. 커밋은 유지되고 코드는 최신 상태가 됩니다.

삭제하기

업데이트가 주인공이지만, 삭제도 그만큼 간단합니다. 이 과정은 시스템에서 Hermes를 깔끔하게 제거하므로, 디지털 잔해물을 남기지 않고 작별 인사를 할 수 있습니다.

마무리

Hermes Agent는 업데이트를 최고 수준의 경험으로 취급합니다. 안전하고, 되돌릴 수 있으며, 투명합니다. 업데이트 전 스냅샷, 구문 오류 시 자동 롤백, 그리고 똑똑한 브랜치 처리는 어떤 상황에서도 어시스턴트가 계속 작동할 것이라는 확신을 가지고 업데이트할 수 있게 해줍니다.

그러니 지금 바로 hermes update를 실행하고 AI 어시스턴트가 여러분과 함께 성장하도록 하세요. 최첨단을 유지하는 가장 쉬운 방법입니다.