Hermes Agent 구성 튜토리얼
Hermes Agent의 모델, 공급자 및 사용자 정의 엔드포인트는 ~/.hermes/config.yaml에 저장되어 있으며; API Key 등 민감한 정보는 ~/.hermes/.env에 저장됩니다. ai2save는 OpenAI Compatible 인터페이스를 사용하며, Base URL는 **https://ai2save.com/v1**입니다.
1. API Key 생성
- https://ai2save.com/keys를 엽니다.
- 키를 생성하고 대상 모델이 포함된 그룹을 선택합니다.
- 전체
sk-...키를 복사합니다. - 콘솔에 표시되는 실제 모델 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. 재시작 및 확인
- 현재 Hermes 세션 또는 Gateway를 완전히 종료합니다.
- Hermes를 다시 시작합니다.
- 새 세션을 만들고 짧은 질문을 하나 보냅니다.
- 세션에서
/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-apiProvider에만 영향을 미치며,custom에는 자동으로 적용되지 않습니다;config.yaml에서model.base_url를 확인하세요. - YAML 해석 실패:중복된
model:블록이 존재하지 않도록 하고, 모든 필드를 동일한 블록에 합치세요. - 도구 호출 예외:먼저 모델이 tool calling를 지원하는지 확인하고, 짧은 텍스트 요청으로 기준선을 설정한 후 도구 세트를 활성화하세요.