Hermes Agent 설치 방법: 초보자 설정 가이드

Hermes Agent는 Nous Research에서 만든 오픈 소스 AI 에이전트로, 터미널에서 실행되고 다양한 모델 제공업체에 연결되며, 세션 간 유용한 컨텍스트를 기억합니다. 또한 도구, 스킬, 메시징 게이트웨이, 자동화로 기능을 확장할 수 있습니다. 이 가이드에서는 Hermes 설치 방법을 안내합니다. macOS 또는 Windows에서 표준 설치 관리자를 사용할 경우 공식 설치 관리자가 주요 종속성을 처리하므로 Python이나 Node.js를 직접 설치할 필요가 없습니다.

Hermes Agent는 터미널 우선 소프트웨어이므로 명령줄에서 설치합니다. 사용하는 컴퓨터에 맞는 섹션을 선택하세요.

• macOS: Applications > Utilities > Terminal에서 터미널을 열거나, Command + Space를 누른 뒤 "Terminal"을 검색하세요.

• Windows: 먼저 WSL2를 설치하고 Linux 배포판 터미널을 연 다음 Linux 명령을 따르세요.

Git도 필요합니다. Git이 설치되어 있는지 확인하세요:

예상 출력:

git: command not found가 표시되면 먼저 Git을 설치하세요:

macOS에 Homebrew가 없다면 다음을 실행하여 Apple Command Line Tools에서 Git을 설치하세요:

터미널에서 공식 설치 관리자 명령을 복사해 붙여넣으세요:

설치 관리자는 Hermes Agent를 다운로드하고 Python 환경을 준비하며, 필요한 종속성을 설치하고 hermes 명령을 셸 경로에 추가합니다. 일반 사용자 설치에서는 Hermes 데이터가 ~/.hermes/에 저장됩니다.

명령이 완료되면 셸을 다시 로드하세요:

macOS에서 흔히 사용하는 Zsh를 쓴다면 다음을 실행하세요:

예상 결과:

이제 Hermes Agent 명령을 사용할 수 있는지 확인하세요:

예상 결과:

Hermes Agent가 업데이트되면 정확한 버전 번호는 달라질 수 있습니다.

Hermes Agent가 응답하거나 도구를 사용하려면 먼저 모델 제공업체가 필요합니다. 초보자에게는 대화형 설정이 가장 쉽습니다:

마법사에서 Kimi/Moonshot 등의 제공업체를 선택할 수 있습니다. 기본 채팅이 작동하기 전까지는 라우팅, 대체 설정, 게이트웨이 또는 cron을 구성하지 마세요.

기본 모델을 선택합니다. Kimi K3은 Kimi의 최신 플래그십 모델이며, 주로 코딩을 한다면 kimi-k2.7-code가 더 나은 선택입니다.

설정할 값을 이미 알고 있다면 hermes config set을 사용할 수 있습니다. 예:

Hermes Agent에서 Kimi API를 사용하기 전에 Kimi Platform에서 Kimi API 키를 활성화하세요. Tier 2 액세스를 해제하려면 $20 이상을 권장합니다. 그러면 지연 시간이 줄어들고 복잡한 여러 단계 작업에서도 더 안정적인 성능을 지원합니다.

Kimi Platform의 API Keys 섹션으로 이동해 Create API Key를 클릭하세요. API 키를 복사해 안전하게 보관하세요. 키는 생성 시 한 번만 표시됩니다.

Kimi API 키를 붙여넣고 Hermes Agent를 연결하세요.

모델을 구성한 후 클래식 CLI를 시작합니다:

또는 최신 터미널 UI를 사용해 보세요:

선택한 제공업체/모델이 표시된 시작 화면이나 프롬프트가 나타납니다. 간단한 요청으로 테스트해 보세요:

성공하면 다음과 같이 표시됩니다:

Hermes Agent가 열리지만 모델 또는 인증 오류를 반환한다면 다음을 실행하세요:

그런 다음 제공업체를 다시 선택하고 API 키 또는 OAuth 로그인을 확인하세요.

OpenClaw와 마찬가지로 Hermes Agent도 봇으로 작동하며 채팅 앱에 연결할 수 있습니다:

설정 후 게이트웨이 상태를 확인하세요:

터미널에서 모델 제공업체가 작동한 후에만 게이트웨이를 사용하세요. CLI에서 기본 채팅을 완료할 수 없다면 봇도 대개 같은 이유로 실패합니다.

원인: 터미널이 아직 PATH 변경 사항을 다시 불러오지 않았습니다.

해결 방법:

또는:

그런 다음 다음을 시도하세요:

원인: Git이 설치되어 있지 않습니다.

Ubuntu, Debian 또는 WSL2에서의 해결 방법:

Homebrew를 사용하는 macOS에서의 해결 방법:

원인: Hermes Agent는 설치되어 있지만 제공업체 키나 로그인이 구성되지 않았습니다.

해결 방법:

또는 키를 직접 설정하세요:

원인: 업데이트 후 구성 파일이 불완전할 수 있습니다.

해결 방법:

원인: 기본 URL, 모델 이름 또는 컨텍스트 길이가 잘못되었습니다.

해결 방법: 먼저 별도의 클라이언트에서 엔드포인트를 테스트하고, OpenAI 호환 여부를 확인하며, 일반적인 Hermes Agent 워크플로에 필요한 최소 64K 컨텍스트를 모델이 지원하는지 확인하세요.

Hermes Agent를 설치하는 가장 쉬운 방법은 공식 원라인 설치 프로그램을 사용한 뒤 셸을 다시 불러오고, hermes model을 실행한 다음 실제 채팅 한 번과 hermes doctor로 설정을 확인하는 것입니다. 처음에는 한 대의 머신, 하나의 제공업체, 하나의 정상 작동하는 대화로 간단하게 구성하세요. 기본 Hermes Agent 어시스턴트가 안정화되면 Docker 격리, 게이트웨이 봇, 스킬, 예약 자동화, 사용자 지정 모델 제공업체를 안전하게 추가할 수 있습니다.