Hermes

설치 스크립트는 Raon을 Hermes 프로바이더 custom:raon으로 등록하고, 기본 모델로 설정할지 묻습니다. 동의하면 기본 모델을 Raon으로 변경하고, 거절하면 기존 기본 모델을 유지합니다. 다른 프로바이더 설정은 변경하지 않으며, hermes model 명령으로 다른 프로바이더로 전환할 수 있습니다.

기본 모델을 변경할지 묻는 단계에서 Enter 키를 누르면 Raon으로 변경합니다. --yes 옵션(Windows는 -Yes)을 지정해도 기본 모델을 Raon으로 변경합니다. 사용자 입력을 받을 수 없는 환경에서 이 옵션 없이 실행하면 Raon만 등록하고 기존 기본 모델을 유지합니다.

설치이 절의 링크 복사

curl -fsSL https://raon-console.krafton.ai/setup/hermes.sh | bash

설치 스크립트는 Hermes가 설치되어 있지 않으면 먼저 설치한 후, API 키를 입력받아 테스트 호출을 수행합니다. Hermes는 본인만 읽을 수 있는 ~/.raon/hermes.key 파일에서 API 키를 읽습니다.

실행이 절의 링크 복사

hermes
hermes -z "Explain this repository"
hermes model   # 프로바이더 전환

수동 설정이 절의 링크 복사

Hermes의 .env 파일(~/.hermes/.env, Windows는 %LOCALAPPDATA%\hermes\.env)에 API 키를 추가하고 프로바이더를 등록합니다.

echo 'RAON_API_KEY=<your key>' >> ~/.hermes/.env
hermes config set providers.raon '{"name":"Raon","api":"https://raon-api.krafton.ai/v1","key_env":"RAON_API_KEY","transport":"chat_completions","default_model":"raon-1-mini-preview","models":{"raon-1-mini-preview":{"context_length":262144}}}'
hermes config set model.provider custom:raon
hermes config set model.default raon-1-mini-preview
hermes config set model.base_url https://raon-api.krafton.ai/v1

제거이 절의 링크 복사

설치 스크립트가 등록한 Raon 프로바이더와 저장한 API 키를 제거합니다. Hermes 프로그램과 다른 프로바이더의 설정, 도구 설정은 유지합니다. 설치 스크립트가 기본 모델을 Raon으로 변경했다면 설치 전 기본 모델로 복원합니다. 설치 후 사용자가 기본 모델을 변경한 경우에는 사용자가 지정한 값을 유지합니다.

curl -fsSL https://raon-console.krafton.ai/setup/hermes.sh | bash -s -- --uninstall

설치 전에 같은 이름의 Raon 프로바이더나 API 키가 있었다면 원래 값으로 복원합니다. 다만 Raon 프로바이더를 수정했거나 기본 설정 복원 후에도 기본 프로바이더가 Raon으로 설정되어 있으면 프로바이더와 키를 유지하고 그 이유를 표시합니다. 설치할 때는 Raon을 등록만 하고 나중에 기본 모델로 선택한 경우에도 프로바이더와 키를 유지합니다. 설치 후 변경한 API 키도 삭제하지 않습니다.

제거할 때는 설치 스크립트가 남긴 기록을 참조합니다. 수동으로 추가한 설정이나 설치 기록이 없는 이전 버전의 설정은 자동으로 제거하지 않습니다. API 키를 입력하거나 API 서버에 연결할 필요는 없습니다. 다만 설정 변경에 에이전트의 명령을 사용하므로 Hermes가 설치되어 있어야 합니다. 로컬에 저장한 키를 삭제해도 서버에서 발급한 API 키는 폐기되지 않습니다.