Hermes Agent 설치 가이드 1편: 로컬 설치와 첫 설정 | DAKER 커뮤니티

Hermes Agent 설치 가이드 1편: 로컬 설치와 첫 설정

Hermes Agent는 Nous Research가 공개한 오픈소스 AI 에이전트입니다. 핵심 매력은 단순한 챗봇이 아니라, 오래 켜 둘수록 기억과 스킬을 쌓아가며 반복 업무를 더 잘 수행하는 구조에 있습니다. Telegram이나 Slack에서 부르고, 서버에서 계속 실행시키고, 웹과 파일 도구를 연결해 실제 작업 루프를 만들 수 있습니다.

이 시리즈는 설치부터 항상 켜 두는 운영까지 DAKER 독자가 바로 따라 할 수 있게 정리한 실전 가이드입니다. 1편은 로컬 설치와 첫 대화 성공까지 다룹니다.

설치 전에 확인할 것

공식 문서 기준으로 Linux, macOS, WSL2, Android Termux는 같은 설치 스크립트를 사용합니다. Windows 네이티브 실행은 지원하지 않으므로 Windows 사용자는 WSL2 안에서 설치하는 방식이 안전합니다.

선행 조건은 Git입니다. Python, Node.js, ripgrep, ffmpeg, uv 같은 의존성은 설치 스크립트가 처리합니다. 먼저 터미널에서 Git이 있는지 확인합니다.

git --version

Git이 없다면 macOS는 Xcode Command Line Tools 또는 Homebrew로, Ubuntu/WSL2는 apt로 설치합니다.

# macOS에서 Xcode Command Line Tools 설치
xcode-select --install

# Ubuntu 또는 WSL2
sudo apt update
sudo apt install -y git curl

한 줄 설치

공식 설치 명령은 다음과 같습니다.

HERMES_INSTALL_SCHEME="https"
HERMES_INSTALL_HOST="raw.githubusercontent.com"
HERMES_INSTALL_PATH="NousResearch/hermes-agent/main/scripts/install.sh"
curl -fsSL "${HERMES_INSTALL_SCHEME}://${HERMES_INSTALL_HOST}/${HERMES_INSTALL_PATH}" | bash

설치 스크립트는 저장소 클론, Python 환경, Node.js 런타임, 글로벌 Hermes 명령 연결, 기본 LLM provider 설정 흐름을 자동화합니다. 설치가 끝난 뒤 현재 셸에 새 PATH가 반영되지 않았다면 셸 설정을 다시 읽습니다.

source ~/.zshrc

Bash를 쓰는 환경이라면 다음 명령을 사용합니다.

source ~/.bashrc

첫 설정 실행

설치가 끝나면 전체 설정 마법사를 실행합니다.

hermes setup

여기서 가장 중요한 선택은 provider입니다. OpenRouter, Nous Portal, OpenAI, Anthropic, custom endpoint 같은 선택지가 있으며, 이미 쓰는 API 키가 있다면 해당 provider를 먼저 연결하는 것이 빠릅니다.

설정을 나중에 바꾸고 싶다면 전체 setup을 다시 돌리지 않아도 됩니다.

hermes model

hermes tools

hermes config check

위의 model 명령은 provider와 모델을 다시 고르는 명령입니다. tools 명령은 웹, 브라우저, 파일, 음성 같은 도구 사용 범위를 정리할 때 씁니다. config check 명령은 업데이트 뒤 빠진 설정이 없는지 확인할 때 유용합니다.

설정 파일 위치

Hermes 설정은 기본적으로 홈 디렉터리의 Hermes 설정 폴더 아래에 저장됩니다. API 키와 일반 설정이 섞이지 않도록 구조가 나뉘어 있습니다.

~/.hermes/
├── config.yaml
├── .env
├── auth.json
├── SOUL.md
├── memories/
├── skills/
├── cron/
├── sessions/
└── logs/

설정을 직접 확인하려면 다음 명령을 씁니다.

hermes config

설정 파일을 편집기로 열려면 다음 명령을 사용합니다.

hermes config edit

첫 대화로 검증하기

설치 성공 여부는 긴 자동화가 아니라 짧은 대화로 확인해야 합니다.

hermes

실행 후 다음처럼 간단한 요청을 던져봅니다.

내 Hermes 설정이 정상인지 한 문단으로 확인해줘.

응답이 정상적으로 돌아오면 로컬 설치는 성공입니다. 여기서 바로 Telegram, Slack, cron, 브라우저 자동화까지 붙이고 싶겠지만 순서는 중요합니다. 먼저 provider와 기본 chat이 깨끗하게 작동해야 나머지 기능의 문제를 좁힐 수 있습니다.

자주 막히는 지점

명령을 찾을 수 없다는 오류가 나오면 셸 설정이 아직 반영되지 않은 경우가 많습니다.

source ~/.zshrc

또는 Bash 환경에서 다음을 실행합니다.

source ~/.bashrc

API 키 문제가 나오면 provider 설정을 다시 엽니다.

hermes model

진단이 필요하면 doctor를 실행합니다.

hermes doctor

1편의 목표는 여기까지입니다. "Hermes가 내 터미널에서 대답한다"는 상태를 먼저 만들면, 2편의 gateway, 메시징 채널, 항상 켜 두는 운영 설정이 훨씬 안정적으로 이어집니다.