Hermes Agent 입문: 설치와 사용자 지정 엔드포인트 설정

Hermes Agent 최신 버전 0.21.4의 공식 설치 방법, 첫 실행, 64K 문맥 조건과 OpenAI 호환 엔드포인트 설정을 한국어로 안내합니다.

Hermes Agent 입문: 설치부터 사용자 지정 엔드포인트 설정까지

Hermes Agent는 NousResearch가 공개하는 오픈 소스 AI 에이전트입니다. 터미널에서 대화를 시작하고, 설정에 따라 도구를 사용하는 작업을 이어갈 수 있습니다. 이 글에서는 설치, 첫 실행, 사용자 지정 OpenAI 호환 엔드포인트 설정에 필요한 공식 절차를 살펴봅니다.

공식 릴리스 페이지에서 확인한 최신 버전은 0.21.4입니다. 아래 내용과 링크는 2026-09-24에 확인했습니다. 공식 릴리스

설치와 첫 실행

Linux, macOS, WSL2, Android/Termux에서는 공식 설치 명령을 실행합니다.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows PowerShell에서는 다음 설치 명령을 사용합니다.

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

설치가 끝나면 새 터미널을 열고 Hermes를 실행합니다. 터미널 UI로 시작하려면 hermes --tui를 사용할 수 있습니다.

hermes
hermes --tui

처음에는 파일을 요약하거나 짧은 질문에 답하는 등 결과를 직접 확인할 수 있는 작업으로 실행해 보세요. Hermes 공식 Quickstart는 에이전트의 도구 사용을 위해 모델 문맥이 최소 64K 토큰이어야 한다고 안내합니다. 설치 안내 · Quickstart · TUI 안내

사용자 지정 OpenAI 호환 엔드포인트 연결

Hermes 설정 문서는 사용자 지정 공급자를 providers 아래에 정의하고, 모델 설정에서 custom:<이름> 형식으로 선택하는 방법을 안내합니다. API 키는 설정 파일에 직접 적지 말고 환경 변수로 읽게 합니다. 다음 예시는 BazaarLink API 주소와 현재 공개 모델 목록에서 확인할 수 있는 모델 ID를 사용합니다. 사용자 지정 공급자 안내 · 모델 목록

먼저 키를 Hermes 환경 파일에 둡니다.

# ~/.hermes/.env
BAZAARLINK_API_KEY=발급받은_API_키

그다음 ~/.hermes/config.yaml에 공급자와 기본 모델을 설정합니다.

model:
  provider: custom:bazaarlink
  default: gemini-3.8-flash
providers:
  bazaarlink:
    api: https://api.bazaarlink.ai/v1
    key_env: BAZAARLINK_API_KEY
    transport: chat_completions

이 예시의 모델 ID가 현재 공개 목록에 있다는 사실만으로 특정 기능이나 성능까지 보장되는 것은 아닙니다. 사용하려는 모델의 입력 형식과 기능은 해당 제품 문서 및 실제 환경에서 확인하세요. 연결 문제가 있으면 공급자 이름, API 주소, 환경 변수 이름, 선택한 모델 ID를 하나씩 점검하면 설정 오류를 좁히기 쉽습니다.

Hermes 공식 문서와 릴리스, BazaarLink 공개 모델 목록 최종 확인일: 2026-09-24.

대만 달러 결제 · 대만 통일영수증 · 주요 AI 모델 · OpenAI 호환 API