Windows, Mac, Ubuntu에서 Hermes 설치하기

개요

Hermes를 Windows, Mac, Ubuntu 환경에 설치하면서 필요한 내용만 정리했습니다.
설치 명령어, 첫 실행 확인, 자주 막히는 부분 위주로 적었습니다.

사전 준비 사항

설치 전에 아래 항목을 먼저 확인합니다.

• 인터넷 연결
• PowerShell 또는 Terminal 사용 가능 여부
• 사용할 AI 모델 계정 또는 API Key

API Key는 비밀번호와 같습니다. 블로그, GitHub, 메모장에 그대로 올리면 안 됩니다.

설치 절차

Windows는 PowerShell 설치와 WSL2 설치 방식이 나뉩니다.
Mac과 Ubuntu는 같은 설치 스크립트를 사용합니다.

1. Windows 설치 방법

Windows에서는 먼저 native PowerShell 방식으로 설치하는 것을 권장합니다.
Linux 환경에 익숙하거나 서버처럼 쓰고 싶다면 WSL2 방식도 괜찮습니다.

1.1. Windows native 방식

시작 메뉴에서 PowerShell을 검색합니다.
마우스 오른쪽 버튼을 누르고 관리자 권한으로 실행을 선택합니다.

아래 명령어를 붙여 넣고 Enter를 누릅니다.

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

설치가 끝나면 새 PowerShell 창을 열고 Hermes를 실행합니다.

hermes

설정 화면이 나오면 설치가 정상적으로 된 상태입니다.

1.2. Windows WSL2 방식

WSL2는 Windows 안에서 Ubuntu 같은 Linux 환경을 실행하는 기능입니다.
개발 서버처럼 Hermes를 쓰고 싶을 때 편합니다.
PowerShell에서 아래 명령어를 실행합니다.

wsl --install

설치 후 PC를 재부팅합니다.
재부팅 후 Ubuntu를 실행하고 사용자 이름과 비밀번호를 만듭니다.
Ubuntu 터미널에서 설치 스크립트를 실행합니다.

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

설치가 끝나면 터미널을 다시 열고 실행합니다.

hermes

2. Mac 설치 방법

Mac에서는 기본 Terminal 앱을 사용하면 됩니다.
Launchpad에서 Terminal을 검색해서 실행합니다.
아래 명령어를 실행합니다.

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

설치 후 터미널을 새로 열고 Hermes를 실행합니다.

hermes

command not found: hermes가 나오면 터미널을 완전히 종료했다가 다시 열어봅니다.
그래도 안 되면 아래 명령어를 실행합니다.

source ~/.zshrc

3. Ubuntu 설치 방법

Ubuntu 서버나 데스크톱에서는 터미널에서 바로 설치하면 됩니다.
먼저 curl을 준비합니다.

sudo apt update
sudo apt install -y curl

설치 스크립트를 실행합니다.

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

설치가 끝나면 터미널을 다시 열고 실행합니다.

hermes

SSH로 접속한 서버에서도 같은 방식으로 설치할 수 있습니다.

4. 첫 실행 설정

처음 실행하면 Hermes가 사용할 모델과 API Key를 물어볼 수 있습니다.
OpenAI, Anthropic, OpenRouter 같은 모델 제공사 중 사용할 항목을 선택하고 Key를 입력하면 됩니다.
설정을 다시 하고 싶을 때는 아래 명령어를 사용합니다.

hermes setup

모델을 바꾸고 싶을 때는 아래 명령어를 사용합니다.

hermes model

5. 설치 확인

설치 후 Hermes에게 간단한 파일 작업을 시켜보면 됩니다.
예를 들어 아래처럼 요청합니다.

현재 폴더에 있는 파일 목록을 알려줘

또는 테스트 파일을 만들어 달라고 요청해도 됩니다.

hello.txt 파일을 만들고 안에 Hello Hermes 라고 적어줘

파일이 만들어지면 로컬 작업 실행까지 확인된 상태입니다.

주요 오류 및 해결 방안

6.1. hermes 명령어를 찾을 수 없음

설치 후 바로 실행하면 터미널이 새 PATH 값을 못 읽을 수 있습니다.
터미널을 완전히 닫고 다시 열어봅니다.
Mac이나 Ubuntu에서는 아래 명령어도 확인합니다.

source ~/.bashrc
source ~/.zshrc

6.2. API Key 오류

API Key가 틀렸거나 모델 제공사 계정에 사용 권한이 없을 때 발생합니다.
아래 항목을 확인합니다.

• API Key가 정확한지
• 복사할 때 앞뒤 공백이 들어갔는지
• 모델 제공사 계정에 사용 가능한 크레딧이 있는지
• 선택한 모델 이름이 맞는지

6.3. Windows에서 스크립트 실행이 막힘

PowerShell 실행 정책 때문에 설치 스크립트가 막히는 경우가 있습니다.
PowerShell을 관리자 권한으로 열고 다시 시도합니다.
그래도 막히면 아래 명령어를 실행한 뒤 설치 명령어를 다시 실행합니다.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

실행 정책은 보안과 관련된 설정입니다. 설치 후 필요하면 기존 정책으로 되돌려도 됩니다.

확인

정리하면 Windows는 PowerShell, Mac과 Ubuntu는 Terminal에서 설치하면 됩니다.

• Windows native: iex (irm https://hermes-agent.nousresearch.com/install.ps1)
• Mac: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
• Ubuntu: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

설치 후 hermes 명령어가 실행되고 간단한 파일 작업까지 되면 기본 설정은 끝입니다.