CometAPI와 함께 Hermes Agent 사용하기

CometAPI를 Hermes Agent의 model provider로 사용하세요. 이 가이드에서는 Hermes가 두 가지 CometAPI 경로를 지원합니다. 대부분의 텍스트 모델용 일반적인 OpenAI 호환 엔드포인트와 Anthropic 메시지를 통한 Claude 경로입니다.

사전 준비

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

설치

CometAPI API 키 가져오기

CometAPI 콘솔에 로그인하세요. Add API Key를 클릭하고 CometAPI API 키를 복사하세요.

Hermes Agent 설치하기

다음 명령어는 공식 설치 프로그램을 실행합니다:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

현재 셸에서 아직 hermes 명령어가 보이지 않는다면, 셸 구성을 다시 불러오세요:

source ~/.zshrc
# or
source ~/.bashrc

Hermes는 설정을 ~/.hermes/에 저장하고, hermes 명령어를 ~/.local/bin에 링크하며, ~/.local/bin을 셸 PATH에 추가할 수 있습니다.

구성

모델 계열에 맞는 CometAPI 경로를 선택하세요:

모델 계열	Hermes 구성	CometAPI 경로
OpenAI 호환 텍스트 모델	`model.provider: custom` 및 `base_url: https://api.cometapi.com/v1`	`/v1/chat/completions`
Claude 모델	`transport: anthropic_messages`를 사용하는 이름 있는 provider	`/v1/messages`
Hermes의 Gemini 모델	OpenAI 호환 구성을 사용	`/v1/chat/completions`
직접 Gemini API 호출	Hermes 외부에서 Gemini `generateContent` API 사용	`/v1beta` `generateContent`

Hermes를 https://api.cometapi.com/v1beta로 사용자 지정 Gemini 네이티브 provider로 구성하지 마세요. Gemini 모델에는 OpenAI 호환 Hermes 구성을 사용하세요. 직접 Gemini API를 호출하려면 Gemini generateContent API를 사용하세요.

CometAPI 키 저장

~/.hermes/.env를 열고 다음 값을 추가하세요:

COMETAPI_KEY=<COMETAPI_KEY>
OPENAI_API_KEY=<COMETAPI_KEY>

COMETAPI_KEY는 이름 있는 Claude provider에서 사용됩니다. OPENAI_API_KEY는 Hermes의 사용자 지정 OpenAI 호환 엔드포인트 폴백이 계속 작동하도록 합니다.

OpenAI 호환 경로 구성

이 경로는 Hermes에서 사용하는 Gemini 모델을 포함해 대부분의 CometAPI 텍스트 모델에 사용합니다. ~/.hermes/config.yaml를 열고 model 섹션이 다음과 같은지 확인하세요:

model:
  provider: custom
  default: your-model-id
  base_url: https://api.cometapi.com/v1

your-model-id를 CometAPI Models page의 현재 텍스트 model ID로 바꾸세요.

API 키는 ~/.hermes/.env에 보관하세요. config.yaml에 비밀 정보를 하드코딩하지 마세요.

이 설정은 기본 채팅 모델을 구성합니다. Hermes는 비전이나 웹 추출 같은 작업에 별도의 보조 모델을 사용할 수 있습니다.

Claude Messages 경로 구성

Hermes가 Anthropic 메시지를 통해 Claude 모델을 호출하도록 하려면 이 경로를 사용하세요. ~/.hermes/config.yaml를 열고 이름 있는 provider를 사용하세요:

model:
  provider: cometapi-claude
  default: your-claude-model-id

providers:
  cometapi-claude:
    base_url: https://api.cometapi.com
    key_env: COMETAPI_KEY
    transport: anthropic_messages
    default_model: your-claude-model-id

your-claude-model-id를 CometAPI Models page의 현재 Claude model ID로 바꾸세요.

이 경로에서는 base_url을 https://api.cometapi.com로 유지하세요. Hermes는 이름 있는 provider의 Anthropic Messages transport를 사용합니다.

검증

구성 확인

다음 명령은 Hermes가 config와 API 키를 읽을 수 있는지 확인합니다:

hermes config check

업데이트 후 hermes config check에서 누락된 옵션이 보고되면 hermes config migrate를 실행한 뒤 다시 확인하세요.

실제 채팅 테스트 실행

다음 명령은 CometAPI를 통해 실제 요청을 보냅니다:

hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."

설정이 성공하면 CONNECTED가 반환되며 auth 또는 endpoint 오류가 없어야 합니다. Claude Messages 구성이 활성화된 경우, 이는 Hermes가 CometAPI를 통해 anthropic_messages transport를 사용할 수 있음을 확인해 줍니다.

선택적 구성

클린 재설치(선택 사항)

이전 Hermes 설치를 교체하는 경우, 먼저 내장 제거 프로그램을 사용하세요:

hermes uninstall

제거 프로그램에서 CLI, PATH 항목, ~/.hermes/ 데이터를 제거하려면 Full uninstall을 선택하세요. 그런 다음 설치 단계를 다시 실행하고 동일한 CometAPI 구성으로 계속 진행하세요.

대신 hermes model 사용(선택 사항)

OpenAI 호환 경로에 대해 대화형 흐름을 선호한다면 hermes model을 실행하고 Custom endpoint를 선택하세요.그런 다음 다음 값을 입력하세요:

Base URL: https://api.cometapi.com/v1
API key: CometAPI API 키
Model: 현재 CometAPI 텍스트 model ID

이 흐름은 OpenAI 호환 provider 설정을 config.yaml에 기록합니다. Claude Messages의 경우, 이름이 지정된 provider가 transport: anthropic_messages를 유지하도록 config.yaml을 직접 편집하세요.

개요

AI 코딩 에이전트

AI 에이전트

AI 채팅 클라이언트

번역 및 언어

자동화 플랫폼

관측성 및 평가

AI 프레임워크

CometAPI와 함께 Hermes Agent 사용하기

사전 준비

설치

구성

검증

선택적 구성

​사전 준비

​설치

​구성

​검증

​선택적 구성

사전 준비

설치

구성

검증

선택적 구성