메인 콘텐츠로 건너뛰기
Hermes의 사용자 지정 OpenAI 호환 endpoint 지원을 통해 Hermes Agent의 model provider로 CometAPI를 사용하세요.

​
사전 요구 사항

  • Git
  • 활성 API 키가 있는 CometAPI 계정
  • macOS, Linux 또는 WSL2의 터미널

​
설치

1

CometAPI API 키 가져오기

CometAPI 콘솔에 로그인하세요. Add API Key를 클릭하고 <COMETAPI_KEY> 키를 복사하세요.
Add API Key 버튼이 표시된 CometAPI 대시보드
base URL이 표시된 CometAPI API 키 상세 정보
2

Hermes Agent 설치

다음 명령어는 공식 설치 프로그램을 실행합니다:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
현재 셸에서 아직 hermes 명령어를 인식하지 못한다면, 셸 설정을 다시 로드하세요:
source ~/.zshrc
# or
source ~/.bashrc
Hermes는 ~/.hermes/에 config를 저장하고, ~/.local/bin에 hermes 명령어를 연결하며, ~/.local/bin을 셸 PATH에 추가할 수 있습니다.

​
구성

1

CometAPI 키 저장

~/.hermes/.env를 열고 다음 줄을 추가하세요:
OPENAI_API_KEY=<COMETAPI_KEY>
Hermes는 사용자 지정 OpenAI 호환 endpoint에 대한 인증 대체 수단으로 OPENAI_API_KEY를 사용합니다.
2

CometAPI endpoint 구성

~/.hermes/config.yaml을 열고 model 섹션이 다음과 같은지 확인하세요:
model:
  provider: custom
  default: your-model-id
  base_url: https://api.cometapi.com/v1
your-model-id를 CometAPI Models 페이지의 현재 텍스트 model ID로 바꾸세요.
API 키는 ~/.hermes/.env에 보관하세요. config.yaml에 secrets를 하드코딩하지 마세요.
이 설정은 기본 채팅 model을 구성합니다. Hermes는 vision이나 웹 추출 같은 작업에 별도의 보조 model을 사용할 수 있습니다.

​
검증

1

구성 확인

다음 명령어로 Hermes가 config와 API 키를 읽을 수 있는지 확인합니다:
hermes config check
hermes doctor
hermes status
업데이트 후 hermes config check에서 누락된 옵션이 보고되면 hermes config migrate를 실행한 뒤 다시 확인하세요.
2

실제 채팅 테스트 실행

다음 명령어는 CometAPI를 통해 실제 요청을 전송합니다:
hermes chat -q "Reply with the single word CONNECTED."
설정이 성공적이면 CONNECTED가 반환되며 인증 또는 endpoint 오류가 발생하지 않습니다.

​
선택적 구성

이전 Hermes 설치를 교체하는 경우, 먼저 내장 제거 프로그램을 사용하세요:
hermes uninstall
제거 프로그램에서 Full uninstall을 선택하면 CLI, PATH 항목, 그리고 ~/.hermes/ 데이터가 제거됩니다. 그런 다음 설치 단계를 다시 실행하고 동일한 CometAPI 구성으로 계속 진행하세요.
대화형 흐름을 선호한다면 hermes model을 실행하고 Custom endpoint를 선택하세요.그런 다음 다음 값을 입력하세요:
  • Base URL: https://api.cometapi.com/v1
  • API key: CometAPI API 키
  • Model: 현재 CometAPI 텍스트 model ID
이 흐름은 동일한 provider 설정을 config.yaml에 기록합니다.