ai2saveai2save

Hermes Agent 구성 튜토리얼

Hermes Agent의 모델, 공급자 및 사용자 정의 엔드포인트는 ~/.hermes/config.yaml에 저장되어 있으며; API Key 등 민감한 정보는 ~/.hermes/.env에 저장됩니다. ai2save는 OpenAI Compatible 인터페이스를 사용하며, Base URL는 **https://ai2save.com/v1**입니다.

1. API Key 생성

  1. https://ai2save.com/keys를 엽니다.
  2. 키를 생성하고 대상 모델이 포함된 그룹을 선택합니다.
  3. 전체 sk-... 키를 복사합니다.
  4. 콘솔에 표시되는 실제 모델 ID를 기록합니다. 예: gpt-5.5.

2. 내장 마법사 사용 권장

터미널에서 실행:

hermes model

지시에 따라 선택하세요:

Custom endpoint (self-hosted / vLLM / etc.)

순서대로 입력:

API base URL: https://ai2save.com/v1
API key: sk-사용자의 API 키
Model name: gpt-5.5

가이드는 이러한 값을 ~/.hermes/config.yaml에 기록합니다. Base URL를 .env에 기록하지 마십시오; Hermes 공식 규약 모델 endpoint 구성은 config.yaml에서 가져옵니다.

3. 수동으로 구성 파일 편집

~/.hermes/config.yaml 편집:

model:
  provider: custom
  default: gpt-5.5
  base_url: https://ai2save.com/v1
  key_env: AI2SAVE_API_KEY

필드 설명:

  • provider: custom:임의의 OpenAI Compatible 엔드포인트 사용.
  • default:기본 모델 ID, 콘솔에서 공개된 모델 ID와 완전히 일치해야 함.
  • base_url:/v1와 함께 사용해야 하며, Hermes는 이를 기반으로 /chat/completions를 요청함.
  • key_env:키가 저장된 환경 변수 이름을 가리킴.

~/.hermes/.env 편집:

AI2SAVE_API_KEY=sk-사용자의 API 키

.env 민감한 정보를 저장하고, config.yaml 민감하지 않은 모델 구성을 저장합니다. .env 는 Git에 제출하지 마세요.

4. 설정 명령어 사용하여 쓰기

Hermes 자체 명령어를 사용하여 YAML 들여쓰기 오류를 피할 수도 있습니다:

hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-사용자의 API 키
hermes config check

AI2SAVE_API_KEY는 대문자 환경 변수 이름이며, Hermes는 ~/.hermes/.env를 자동으로 작성합니다.

5. 재시작 및 확인

  1. 현재 Hermes 세션 또는 Gateway를 완전히 종료합니다.
  2. Hermes를 다시 시작합니다.
  3. 새 세션을 만들고 짧은 질문을 하나 보냅니다.
  4. 세션에서 /model를 입력하여 현재 모델이 custom/gpt-5.5 또는 gpt-5.5인지 확인합니다.

지정된 모델을 임시로 사용하기:

hermes chat --provider custom --model gpt-5.5

첫 번째 검증에서는 병렬 작업과 복잡한 도구를 끄고 짧은 텍스트만 보내는 것을 권장합니다. 인증과 모델 연결이 완료되면 점차적으로 terminal, web, file 등의 도구를 활성화하세요.

6. 일반적인 오류

  • 401 / invalid_api_key:AI2SAVE_API_KEY가 존재하지 않거나 값이 완전하지 않습니다. hermes config get model.key_env를 실행하여 참조를 확인하세요.
  • 404 / model not found:model.default는 콘솔에서 공개된 실제 모델 ID가 아닙니다.
  • 연결 실패:base_url는 https://ai2save.com/v1이어야 합니다; https://ai2save.com라고 작성하지 마세요.
  • 구성 적용되지 않음:기존 OPENAI_BASE_URL는 openai-api Provider에만 영향을 미치며, custom에는 자동으로 적용되지 않습니다; config.yaml에서 model.base_url를 확인하세요.
  • YAML 해석 실패:중복된 model: 블록이 존재하지 않도록 하고, 모든 필드를 동일한 블록에 합치세요.
  • 도구 호출 예외:먼저 모델이 tool calling를 지원하는지 확인하고, 짧은 텍스트 요청으로 기준선을 설정한 후 도구 세트를 활성화하세요.