Hermes Agent는 Nous Research가 만든 오픈소스 AI agent로, 터미널에서 실행되며 다양한 모델 제공업체에 연결하고, 세션 간에 유용한 맥락을 기억하며, 도구, 스킬, 메시징 게이트웨이, 자동화로 확장할 수 있습니다. 이 가이드는 Hermes를 설치하는 방법을 안내합니다. macOS나 Windows에서 표준 설치 프로그램을 사용하는 경우 Python이나 Node.js를 직접 설치할 필요는 없습니다. 공식 설치 프로그램이 주요 의존성을 대신 처리해주기 때문입니다.
Hermes Agent를 설치하기 전에
Hermes Agent는 터미널 우선(terminal-first) 소프트웨어이므로 명령줄에서 설치하게 됩니다. 사용 중인 컴퓨터에 맞는 항목을 선택하세요:
macOS: 응용 프로그램 > 유틸리티 > 터미널에서 터미널을 열거나, Command + Space를 눌러 "터미널"을 검색하세요.
Windows: 먼저 WSL2를 설치하고, Linux 배포판 터미널을 연 다음 Linux 명령을 따라 하세요.
Git도 필요합니다. Git이 설치되어 있는지 확인하세요:
예상 출력:
git: command not found가 표시되면 먼저 Git을 설치하세요:
macOS에서 Homebrew가 없다면 다음을 실행해 Apple Command Line Tools를 통해 Git을 설치하세요:
1단계: macOS 또는 Windows에 Hermes Agent 설치하기
터미널에 공식 설치 명령을 복사해서 붙여넣으세요:
설치 프로그램은 Hermes Agent를 다운로드하고, Python 환경을 준비하며, 필요한 의존성을 설치하고, hermes 명령을 셸 경로에 추가합니다. 일반 사용자 설치에서는 Hermes 데이터가 ~/.hermes/ 아래에 저장됩니다.
명령이 끝나면 셸을 다시 불러오세요:
macOS에서 흔히 사용하는 Zsh를 사용한다면 다음을 실행하세요:
예상 결과:
이제 Hermes Agent 명령을 사용할 수 있는지 확인하세요:
예상 결과:
정확한 버전 번호는 Hermes Agent가 업데이트됨에 따라 달라질 수 있습니다.
2단계: 모델 제공업체 설정하기
Hermes Agent가 답변하거나 도구를 사용하려면 먼저 모델 제공자를 설정해야 합니다. 초보자에게 가장 쉬운 설정 방법은 대화형 설정입니다:
마법사에서 Kimi/Moonshot과 같은 제공자를 선택할 수 있습니다. 기본적인 채팅이 정상적으로 동작하기 전까지는 라우팅, 폴백, 게이트웨이, cron을 설정하지 마세요.
기본 모델을 선택하세요. kimi-k2.6은 현재까지 Kimi의 가장 발전된 모델입니다.
설정할 값을 이미 알고 있다면 hermes config set을 사용할 수 있습니다. 예를 들면:
API 키가 없다면 Kimi가 좋은 선택이 될 수 있습니다.
1단계: Kimi API 활성화하기
Hermes Agent에서 Kimi API를 사용하기 전에 Kimi 오픈 플랫폼에서 Kimi API 키를 활성화하세요. 20달러 이상을 충전해 Tier 2 접근 권한을 활성화하는 것을 권장합니다. 이를 통해 지연 시간이 줄고 복잡한 다단계 작업에서 더 안정적인 성능을 얻을 수 있습니다.
2단계: Kimi API 키 생성하기
Kimi 오픈 플랫폼의 API Keys 섹션으로 이동해 Create API Key를 클릭하세요. API 키는 생성 시 한 번만 표시되므로 반드시 복사해 안전하게 보관하세요.
3단계: API 키 입력하기
Kimi API 키를 붙여넣고 Hermes Agent를 연결하세요.
3단계: Hermes Agent 시작하기
모델 설정이 끝났다면 클래식 CLI를 실행하세요:
또는 새로운 터미널 UI를 사용해 보세요:
선택한 제공자/모델이 표시된 환영 화면이나 프롬프트가 보일 것입니다. 간단한 요청으로 테스트해 보세요:
성공하면 다음과 같이 표시됩니다:
Hermes Agent가 열리지만 모델 또는 인증 오류가 발생한다면 다음을 실행하세요:
그런 다음 제공자를 다시 선택하고 API 키 또는 OAuth 로그인을 확인하세요.
4단계: Hermes Agent를 봇으로 전환하기
OpenClaw와 마찬가지로 Hermes Agent도 봇 역할을 하며 채팅 앱과 연동할 수 있습니다:
설정 후 게이트웨이 상태를 확인하세요:
터미널에서 모델 제공자가 정상 작동한 후에만 게이트웨이를 사용하세요. CLI에서 기본적인 채팅조차 완료되지 않는다면 봇도 대개 같은 이유로 실패합니다.
Hermes Agent 설치 시 흔히 발생하는 문제
hermes: command not found
원인: 터미널이 아직 PATH 변경 사항을 다시 로드하지 않았습니다.
해결 방법:
또는:
그런 다음 다음을 시도하세요:
git: command not found
원인: Git이 설치되어 있지 않습니다.
Ubuntu, Debian, WSL2에서 해결 방법:
Homebrew를 사용하는 macOS에서 해결 방법:
API 키 미설정
원인: Hermes Agent는 설치되어 있지만 제공업체 키나 로그인이 구성되지 않았습니다.
해결 방법:
또는 키를 수동으로 설정하세요:
hermes doctor에서 구성이 누락되었거나 오래되었다고 표시되는 경우
원인: 업데이트 이후 구성 파일이 불완전할 수 있습니다.
해결 방법:
사용자 지정 엔드포인트는 연결되지만 잘못된 응답을 반환하는 경우
원인: 기본 URL, 모델 이름 또는 컨텍스트 길이가 잘못되었습니다.
해결 방법: 먼저 별도의 클라이언트에서 엔드포인트를 테스트하여 OpenAI와 호환되는지 확인하고, 일반적인 Hermes Agent 워크플로에 필요한 최소 64K 컨텍스트를 모델이 지원하는지 확인하세요.
빠른 명령어 참조
결론
Hermes Agent를 설치하는 가장 쉬운 방법은 공식 한 줄 설치 프로그램을 사용하고, 셸을 다시 로드한 다음 hermes model을 실행하고, 실제 대화 한 번과 hermes doctor로 설정을 확인하는 것입니다. 첫 설정은 간단하게 유지하세요. 하나의 머신, 하나의 제공업체, 하나의 정상 작동하는 대화면 충분합니다. 기본 Hermes Agent 어시스턴트가 안정화되면 Docker 격리, 게이트웨이 봇, 스킬, 예약된 자동화, 사용자 지정 모델 제공업체 등을 안전하게 추가로 구축할 수 있습니다.
자주 묻는 질문
~/.hermes/ 아래에 저장하고, 스킬(skill), 메모리, 예약 작업(scheduled jobs), 메시징 게이트웨이로 확장할 수 있습니다.hermes model을 실행해 Kimi 같은 제공업체를 하나 선택하고, hermes를 시작해 일반적인 채팅을 한 번 테스트한 뒤, hermes doctor를 실행하고, hermes --continue로 세션이 이어지는지 확인하세요. 그런 다음 필요에 따라 Docker 격리, 스킬, MCP 서버, 음성, cron, 또는 메시징 게이트웨이를 추가하면 됩니다.