명령어

개요

이 페이지는 Hermes Agent를 설치하고 처음 실행할 때 자주 쓰는 명령만 모은 빠른 참고표입니다. 자세한 설명은 각 장에서 다루고, 여기서는 복사해서 실행할 수 있는 형태로 정리합니다.

설치

macOS, Linux, WSL2

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

Windows PowerShell

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

PyPI

pip install hermes-agent
hermes postinstall

설치 확인

macOS, Linux, WSL2:

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

Windows PowerShell:

Get-Command hermes
hermes --help

모델 설정

hermes setup
hermes model

Nous Portal을 사용할 때:

hermes setup --portal
hermes portal status

PowerShell:

hermes setup
hermes model

대화 시작

기본 CLI:

hermes

TUI:

hermes --tui

PowerShell:

hermes

단발성 질문

hermes chat -q "현재 폴더의 README 파일을 3줄로 요약해줘."

PowerShell:

hermes chat -q "현재 폴더의 README 파일을 3줄로 요약해줘."

세션 재개

hermes --continue
hermes -c

PowerShell:

hermes --continue

특정 세션으로 돌아갈 때:

hermes --resume 20260225_143052_a1b2c3

Gateway와 Skills

기본 대화가 안정된 뒤에 실행합니다.

hermes gateway setup
hermes skills search kubernetes

빠른 점검 순서

macOS, Linux, WSL2:

command -v hermes
hermes --help
hermes setup
hermes model
hermes
hermes --continue

PowerShell:

Get-Command hermes
hermes --help
hermes setup
hermes model
hermes
hermes --continue

여기까지 되면 설치 확인, 모델 설정, 대화 시작, 세션 재개를 한 번에 점검한 것입니다. 이 묶음에서 실패한 줄이 나오면 그 명령이 속한 장으로 돌아가 원인을 확인합니다.

막힐 때

설치나 첫 실행에서 막히면 새 기능을 더 켜지 말고 아래 명령부터 확인합니다. 대부분의 실패는 실행 경로, 모델 설정, 셸 환경 중 하나에서 발생합니다.

실행 경로 확인:

echo $PATH
command -v hermes

PowerShell:

$env:Path
Get-Command hermes

설치 스크립트 연결 확인:

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

모델 응답이 없을 때는 모델 선택을 다시 엽니다.

hermes model

세션이 이어지지 않을 때는 같은 계정과 같은 작업 폴더에서 실행했는지 확인한 뒤 다시 실행합니다.

hermes --continue

Windows native PowerShell에서 화면이나 입력 문제가 반복되면 Windows WSL2를 열고 Linux 명령 흐름으로 다시 확인합니다. 같은 실패가 WSL2에서도 반복되는지 보면 PowerShell 문제인지 Hermes 설정 문제인지 분리할 수 있습니다.

다음 글

참고 자료