Hermes Agent 실전 가이드
개요
Hermes Agent는 터미널에서 자연어로 대화하며 파일 확인, 명령 실행, 코드 수정, 세션 재개 같은 작업을 수행하는 오픈소스 AI 에이전트입니다. 이 가이드는 Hermes Agent를 처음 설치하는 독자가 막히지 않도록 설치, 첫 대화, 도구, 기억, 퍼스널리티와 컨텍스트, 명령어, 문제 해결 순서로 설명합니다.
이 책의 첫 목표는 단순합니다. 독자가 자기 운영체제에서 hermes --help를 열고, hermes setup과 hermes model을 통과한 뒤, hermes로 첫 대화를 시작하는 것입니다. 그다음 hermes --continue로 직전 세션이 이어지는지 확인하고, 도구와 기억, 퍼스널리티와 컨텍스트로 자연스럽게 넘어갑니다.
첫날의 목표는 Hermes를 많이 설명하는 것이 아니라 처음 실행해 볼 명령을 끝까지 통과하는 것입니다. 이 책을 읽는 순서는 환경 선택, 설치, 모델 설정, 첫 대화, 세션 재개입니다. Hermes를 배울 때의 기준도 이 순서에서 벗어나지 않습니다.
Hermes Agent 실전 가이드는 처음 실행해 볼 명령, 이 책을 읽는 순서, 첫날의 목표, Hermes를 배울 때의 기준, 환경 선택, 이어서 읽기를 한 페이지에서 먼저 잡아 줍니다. 이 표지 페이지는 아카이브 목록이 아니라 Hermes Agent를 실제로 시작하기 위한 입구입니다.
이 책에서 먼저 다루는 범위
처음부터 gateway, MCP, memory, skills, cron을 모두 켜면 어디서 문제가 생겼는지 구분하기 어렵습니다. 그래서 이 책은 기본 CLI를 먼저 다룹니다. 설치와 모델 선택이 안정된 뒤에 확장 기능을 붙이면, 문제가 생겼을 때 원인을 좁히기 쉽습니다.
Hermes Agent는 로컬 개발 폴더를 기준으로 움직입니다. 같은 명령이라도 어느 폴더에서 실행했는지에 따라 읽는 파일과 작업 맥락이 달라집니다. 첫 실행은 빈 폴더보다 README나 설정 파일이 있는 작은 프로젝트에서 해 보는 편이 좋습니다.
중간에 실패하면 확장 기능을 더 켜지 말고 바로 앞 단계로 돌아갑니다. hermes --help가 안 열리면 설치 문제이고, hermes model에서 막히면 모델 설정 문제이며, hermes --continue가 비어 보이면 세션 경로나 사용자 계정을 먼저 확인합니다.
운영체제별 시작 경로
| 운영체제 | 권장 경로 | 설명 |
|---|---|---|
| macOS | Terminal 또는 iTerm2 | 로컬 개발 장비에서 바로 시작하기 좋습니다. |
| Linux | Bash 또는 Zsh | 서버, VPS, SSH 작업에 적합합니다. |
| Windows WSL2 | Ubuntu 터미널 | Windows 사용자에게 가장 안정적인 시작 경로입니다. |
| Windows PowerShell | PowerShell 7 | 바로 실행할 수 있지만 일부 기능은 차이가 날 수 있습니다. |
Windows 사용자는 WSL2를 먼저 권장합니다. Windows native PowerShell 설치도 제공되지만, 터미널 UI와 경로 처리까지 고려하면 WSL2가 더 예측하기 쉽습니다.
macOS와 Linux에서 시작하기
macOS와 Linux에서는 같은 셸 설치 흐름을 사용합니다. 설치 뒤에는 현재 셸이 새 실행 경로를 읽도록 프로필을 다시 불러옵니다.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc 2>/dev/null || source ~/.zshrc 2>/dev/null || true
hermes --help서버나 SSH 환경처럼 브라우저가 없는 곳에서는 --skip-browser 옵션을 붙입니다.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser
hermes --helpWindows WSL2에서 시작하기
Windows에서는 PowerShell에서 Ubuntu WSL2를 열고, 그 안에서 Linux 설치 명령을 실행합니다. 이 방식은 파일 경로와 셸 명령이 Linux 기준으로 맞춰지기 때문에 처음 배우기 쉽습니다.
wsl -d UbuntuWSL2 안으로 들어간 뒤에는 bash 명령을 사용합니다.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc 2>/dev/null || source ~/.zshrc 2>/dev/null || true
hermes --helpWindows PowerShell에서 시작하기
Windows native PowerShell에서 바로 실행해야 한다면 PowerShell 7을 사용합니다. 이 경로는 빠르게 시험하기 좋지만, 문제가 반복되면 WSL2로 전환하는 편이 좋습니다.
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)
Get-Command hermes
hermes --help모델 설정
설치가 끝났다면 사용할 모델과 프로바이더를 정합니다. 처음에는 설정 마법사를 통과한 뒤 모델 선택 화면을 여는 정도면 충분합니다.
hermes setup
hermes modelPowerShell에서도 같은 명령을 씁니다.
hermes setup
hermes model첫 대화와 세션 재개
기본 대화는 hermes로 시작합니다. 첫 질문은 짧게 하고, 현재 작업 폴더를 읽을 수 있는지 확인합니다.
hermes첫 요청 예시는 다음처럼 간단하게 둡니다.
현재 작업 폴더의 파일 구성을 간단히 설명해줘.대화를 종료한 뒤에는 직전 세션이 이어지는지 확인합니다.
hermes --continuePowerShell에서도 같은 흐름으로 확인합니다.
hermes
hermes --continue읽는 순서
처음 읽는 독자는 아래 순서대로 진행합니다.
이어서 읽기
먼저 Hermes Agent란 무엇인가를 읽고, 곧바로 설치로 넘어갑니다. 설치가 이미 끝났다면 빠른 시작에서 모델 설정과 첫 대화를 확인하고, 이어서 CLI, 첫 번째 대화와 도구(Tools) 시스템으로 확장합니다.