01-1. Hermes Agent란 무엇인가
개요
Hermes Agent는 Nous Research가 공개한 오픈소스 AI 에이전트입니다. 터미널에서 hermes 명령을 실행하면 대화가 시작되고, 사용자는 자연어로 파일 확인, 명령 실행, 코드 수정, 검색, 세션 재개 같은 일을 맡길 수 있습니다.
일반 챗봇은 답변창 안에서 끝나는 경우가 많습니다. Hermes Agent는 작업 폴더를 읽고, 셸 명령 결과를 확인하며, 필요한 도구를 호출해 실제 작업 흐름에 들어갑니다. 그래서 이 책에서는 Hermes를 “답변을 생성하는 프로그램”이 아니라 “터미널에서 함께 일하는 에이전트”로 다룹니다.
처음부터 모든 기능을 켤 필요는 없습니다. 먼저 설치가 끝났는지 확인하고, 사용할 모델을 고른 뒤, 짧은 대화를 열어 봅니다. 그다음 hermes --continue로 직전 세션이 이어지는지 확인하면 기본 흐름이 잡힙니다.
활용 사례
Hermes Agent는 로컬 개발 폴더를 읽고 현재 상태를 설명합니다. 예를 들어 README, 설정 파일, 테스트 결과를 함께 보며 “어디서부터 고치면 되는지”를 정리합니다. 코드 수정이 필요한 경우에는 변경 전후를 확인하면서 작은 단위로 맡기는 편이 좋습니다.
서버나 VPS에서도 Hermes Agent를 사용합니다. SSH로 접속한 Linux 환경에서 로그를 요약하거나, 배포 전에 필요한 점검 명령을 순서대로 실행하게 합니다. 운영 서버에서는 읽기 명령과 변경 명령을 반드시 나누어 다루어야 합니다.
메시징 게이트웨이를 붙이면 터미널 앞에 앉아 있지 않아도 작업을 요청합니다. Telegram, Slack, Discord 같은 경로를 설정하면 외부에서 상태 요약을 요청하고 결과를 받습니다. 이 단계는 기본 CLI가 안정된 뒤에 붙이는 것이 좋습니다.
장기 작업에서는 세션 재개가 중요합니다. 하루에 끝나지 않는 조사나 문서화 작업은 직전 대화와 작업 폴더를 다시 찾아야 이어갈 수 있습니다. hermes --continue는 이 흐름을 확인하는 가장 기본적인 명령입니다.
핵심 기능
Hermes Agent의 핵심 기능은 터미널에서 시작합니다. 사용자는 hermes 명령으로 대화를 열고, 필요한 작업을 자연어로 지시합니다. 처음에는 긴 자동화보다 현재 폴더를 설명하게 하거나 도움말을 확인하는 짧은 요청부터 시작합니다.
대화형 CLI는 가장 기본적인 입구입니다. CLI가 안정적으로 동작해야 TUI, gateway, MCP, skills 같은 확장 기능도 의미가 있습니다. 화면이 깨지거나 입력이 불안정하다면 먼저 일반 CLI에서 같은 요청이 처리되는지 확인합니다.
대화형 CLI
기본 대화는 아래 명령으로 엽니다.
hermes터미널 UI를 쓰고 싶다면 다음 명령을 사용합니다.
hermes --tui처음 실행 후에는 현재 폴더를 읽는 간단한 질문을 던집니다. 이렇게 하면 모델 설정 문제와 작업 폴더 문제를 빠르게 분리합니다.
유연한 모델 연결
Hermes Agent는 모델과 프로바이더 설정을 분리해서 다룹니다. 사용자는 hermes setup으로 기본 설정을 열고, hermes model로 사용할 모델을 고릅니다. 이 구조 덕분에 비용, 응답 속도, 컨텍스트 길이에 맞춰 모델을 바꿀 수 있습니다.
모델 선택은 단순한 취향 문제가 아닙니다. 코드 수정, 긴 문서 요약, 빠른 질의응답은 각각 잘 맞는 모델이 다를 수 있습니다. 처음에는 하나의 모델로 설치와 첫 대화를 확인하고, 이후 작업 성격에 맞춰 조정합니다.
도구와 MCP 확장
Hermes Agent는 파일과 셸 명령을 다루는 도구를 통해 실제 작업에 접근합니다. 여기에 MCP를 붙이면 외부 서비스나 내부 도구와 연결할 수 있는 폭이 넓어집니다. 다만 도구가 많아질수록 권한 경계를 분명히 해야 합니다.
처음부터 모든 도구를 켜지 않는 이유도 여기에 있습니다. 설치, 모델, 기본 대화가 안정된 뒤에 MCP를 붙여야 문제가 생겼을 때 원인을 찾을 수 있습니다. 이 책에서는 기본 명령을 먼저 확인한 뒤 확장 기능으로 넘어갑니다.
메모리와 스킬
Hermes Agent는 반복되는 작업 맥락을 Memory System과 Skills System으로 정리합니다. Memory System은 다시 참고해야 할 사용자 선호나 작업 맥락을 보관하는 쪽에 가깝습니다. Skills System은 반복 절차를 재사용 가능한 형태로 남기는 쪽에 가깝습니다.
두 기능은 편의 기능으로만 보면 안 됩니다. 에이전트가 같은 실수를 반복하지 않게 하려면, 이전 판단과 절차가 나중에 다시 검색되어야 합니다. 장기 운영에서는 메모리와 스킬이 업무 기록과 문서화 흐름의 기반이 됩니다.
기술 스택
Hermes Agent는 Python 기반 CLI와 에이전트 루프를 중심으로 동작합니다. 모델 프로바이더 설정, 도구 호출, 세션 관리가 이 흐름 안에서 이어집니다. 대시보드나 웹 화면이 붙는 경우에는 JavaScript 기반 프런트엔드도 함께 사용됩니다.
사용자가 처음 신경 써야 할 기술 스택은 복잡하지 않습니다. 터미널, Python 실행 환경, 네트워크 연결, 모델 API 키가 기본입니다. 이 네 가지가 맞아야 설치와 첫 대화가 안정적으로 진행됩니다.
실행 환경은 macOS, Linux, Windows WSL2, Windows native PowerShell로 나누어 생각합니다. macOS와 Linux는 셸 명령이 거의 같은 흐름으로 이어집니다. Windows에서는 WSL2가 기본 경로이고, Windows native PowerShell은 별도 안내를 보며 확인합니다.
최신 버전
이 가이드는 2026년 5월 31일에 확인한 Hermes Agent 공개 문서와 저장소 흐름을 기준으로 작성했습니다. 설치할 때는 공식 문서와 GitHub 저장소의 최신 안내를 함께 확인하는 편이 좋습니다.
버전 번호보다 먼저 볼 것은 실행 가능 여부입니다. hermes --help가 열리고, hermes setup, hermes model, hermes, hermes --continue가 차례대로 통과하면 다음 장으로 넘어갈 준비가 된 것입니다.
처음 확인할 일
설치 후에는 많은 기능을 한 번에 시험하지 말고 아래 순서만 먼저 확인합니다.
hermes --help
hermes setup
hermes model
hermes
hermes --continuePowerShell에서도 같은 흐름으로 확인합니다.
hermes --help
hermes setup
hermes model
hermes
hermes --continue이 다섯 단계가 통과하면 설치, 모델 설정, 첫 대화, 세션 재개까지 확인한 것입니다. 이후 장에서 운영체제별 설치와 빠른 시작을 더 자세히 다룹니다.