설치

개요

Hermes Agent를 설치하고, 터미널에서 hermes 명령이 잡히는지 확인합니다. 운영체제별 명령을 그대로 복사해 실행한 뒤, 도움말이 출력되면 설치 단계는 통과한 것입니다.

처음 설치하는 독자는 macOS, Linux, Windows WSL2 중 하나를 권장합니다. Windows PowerShell 설치도 가능하지만, 터미널 UI와 경로 처리에서 차이가 날 수 있으므로 처음 배우는 단계에서는 WSL2가 더 다루기 쉽습니다.

터미널을 열고 아래 명령을 실행합니다.

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

브라우저를 띄우지 않고 터미널에서만 설치를 진행하려면 --skip-browser 옵션을 붙입니다.

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser

설치가 끝나면 셸 설정을 다시 읽고 실행 파일을 확인합니다.

source ~/.zshrc 2>/dev/null || source ~/.bashrc 2>/dev/null || true
command -v hermes
hermes --help

Ubuntu, Debian, VPS, SSH 서버에서는 아래 명령으로 설치합니다.

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

서버처럼 브라우저가 없는 환경에서는 다음 명령을 사용합니다.

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser

설치 후 확인 명령입니다.

source ~/.bashrc 2>/dev/null || source ~/.zshrc 2>/dev/null || true
command -v hermes
hermes --help

Windows에서는 먼저 PowerShell을 열고 Ubuntu WSL2로 들어갑니다.

wsl -d Ubuntu

Ubuntu 터미널 안에서 Linux 설치 명령을 실행합니다.

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

설치가 끝나면 같은 WSL2 터미널에서 확인합니다.

source ~/.bashrc 2>/dev/null || source ~/.zshrc 2>/dev/null || true
command -v hermes
hermes --help

PowerShell 7을 사용한다면 아래 명령으로 Windows native 설치를 시도할 수 있습니다.

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

설치 후 현재 PowerShell 세션에서 실행 파일을 확인합니다.

Get-Command hermes
hermes --help

PowerShell에서 경로나 인코딩 문제가 반복되면 WSL2로 전환해 설치하는 편이 좋습니다. Windows native 경로는 문서상 early beta 성격의 실행 경로로 보고, 문제가 생기면 Linux 터미널 흐름으로 돌아갑니다.

Python 환경을 직접 관리하는 사용자는 PyPI 패키지로 설치할 수 있습니다.

pip install hermes-agent
hermes postinstall
hermes --help

가상환경을 쓰는 경우에는 Hermes를 실행할 때도 같은 가상환경이 활성화되어 있어야 합니다.

설치가 끝났다면 모델과 프로바이더를 설정합니다. 일반적인 경우에는 hermes setup과 hermes model만 실행해도 됩니다.

hermes setup
hermes model

PowerShell에서도 같은 명령을 사용합니다.

hermes setup
hermes model

Nous Portal을 사용한다면 포털 설정과 상태 확인 명령을 함께 실행합니다.

hermes setup --portal
hermes portal status

모델 설정까지 끝났다면 빠른 시작으로 넘어가 첫 대화와 세션 재개를 확인합니다.

hermes 명령을 찾을 수 없다는 메시지가 나오면 터미널을 닫고 다시 연 뒤 확인합니다.

command -v hermes
echo $PATH

PowerShell에서는 다음 명령으로 확인합니다.

Get-Command hermes
$env:Path

다운로드가 실패하면 네트워크나 프록시 문제일 수 있습니다. 설치 스크립트 주소가 열리는지 먼저 확인합니다.

curl -I https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh

PowerShell에서는 다음처럼 확인합니다.

Invoke-WebRequest -Method Head https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1