초보자를 위한 Hermes Agent Desktop·Bot Mode 완전 입문서
Hermes Agent를 Windows, macOS, Linux에 설치하고 Bot Mode에서 리서치봇, 글쓰기봇, 검수봇을 만드는 과정을 처음부터 설명합니다. 모델 연결, 그룹 채팅, 예약 실행, 오류 해결법까지 한 번에 따라 해보세요.
AI에게 한 번 질문하고 답을 받는 데서 그치지 않고, 역할이 다른 AI를 여러 명 만들어 계속 일하게 할 수는 없을까요?
예를 들어 이런 식입니다.
리서치봇은 교육부와 대학의 새 자료를 찾습니다.
글쓰기봇은 찾은 자료를 블로그 원고로 바꿉니다.
검수봇은 날짜, 수치, 출처를 다시 확인합니다.
Hermes Agent의 Bot Mode는 이런 구성을 데스크톱 화면에서 만들도록 도와주는 기능입니다. 이름은 거창하지만 원리는 단순합니다. 한 컴퓨터 안에 업무별 AI 프로필을 여러 개 만들고, 각 프로필에 역할과 기억, 모델, 도구를 따로 주는 방식입니다.
가장 먼저 알아둘 점이 하나 있습니다. Bot Mode만 따로 설치하는 프로그램은 아닙니다. Hermes Desktop에 기본으로 들어 있으며 처음부터 켜져 있습니다. Hermes Desktop을 설치하면 왼쪽에 Sessions | Bots 탭이 보입니다. Hermes Bot Mode 공식 안내
이 글에서는 가장 쉬운 Windows 설치부터 시작하겠습니다. macOS와 Linux 사용자를 위한 방법도 뒤에 따로 적었습니다.
1. 설치 전에 3분만 확인하세요
내 컴퓨터에서 실행할 수 있을까?
공식 지원표에는 Windows 10·11, Apple Silicon Mac, Linux·WSL2가 Tier 1으로 올라 있습니다. 반면 Intel Mac은 현재 공식 지원 대상이 아닙니다. 설치하기 전에 자신의 Mac이 Apple Silicon인지 확인하세요. 화면 왼쪽 위 사과 메뉴에서 이 Mac에 관하여를 열고 칩 항목에 M1, M2, M3처럼 표시되면 Apple Silicon입니다. Hermes 플랫폼 지원표
무료 프로그램과 모델 사용료는 구분해야 합니다
Hermes Agent 자체는 MIT 라이선스의 오픈 소스 프로그램입니다. 그러나 Hermes가 답변을 만들 때 부르는 AI 모델은 별개입니다. 선택한 공급자와 요금제에 따라 구독료나 API 사용료가 생길 수 있습니다.
초기 설정에서 선택지는 크게 두 갈래입니다.
Nous Portal로 빠르게 연결하기: OAuth 로그인으로 모델과 Tool Gateway를 한꺼번에 설정하는 쉬운 경로입니다.
내가 쓰는 공급자 연결하기:
hermes model에서 OpenAI Codex 구독 로그인이나 각 공급자의 API 키 방식을 선택합니다.
API를 처음 써 본다면 “무료 프로그램이니 AI 호출도 전부 무료겠지”라고 생각하기 쉽습니다. 예약 작업을 여러 개 돌리기 전에는 반드시 선택한 모델의 과금 방식을 확인하세요. Hermes Quickstart의 모델 연결 안내
2. Windows에서 가장 쉽게 설치하기
Windows 10·11 사용자라면 터미널보다 Desktop 설치 파일을 권합니다.
1단계: 공식 사이트에서 내려받기
Hermes Agent 공식 다운로드 페이지를 엽니다. 화면의 Windows → Download desktop app을 누르세요.
검색 광고나 파일 공유 사이트에서 설치 파일을 받지 마세요. 설치 파일은 공식 도메인 hermes-agent.nousresearch.com에서 출발한 링크인지 확인하는 편이 안전합니다.
2단계: 설치 파일 실행하기
다운로드한 Windows 설치 파일을 더블클릭합니다. 안내에 따라 설치를 마친 뒤 Hermes Desktop을 실행하세요.
첫 실행 때는 화면 뒤에서 Hermes Agent 본체와 필요한 실행 환경을 준비합니다. 공식 설치기는 Python, Node.js, Git, ripgrep, ffmpeg 같은 의존성을 자동으로 처리합니다. 그러니 초보자가 이것들을 하나씩 미리 설치할 필요는 없습니다. 첫 준비에는 인터넷 속도에 따라 시간이 조금 걸릴 수 있습니다. 창을 급하게 닫지 말고 완료될 때까지 기다리세요. 공식 설치 안내
3단계: Local 설치를 선택하기
처음 실행하면 기존 Hermes 서버에 연결할지, 이 컴퓨터에 Hermes를 설치할지 묻는 화면이 나올 수 있습니다. 별도 서버를 운영하지 않는 일반 사용자는 이 컴퓨터에 로컬로 설치하는 선택지를 고르면 됩니다.
4단계: AI 모델 연결하기
가장 쉬운 방법은 Nous Portal 빠른 설정입니다. 브라우저가 열리면 로그인과 승인 절차를 마치고 Desktop으로 돌아오세요.
이미 사용하는 모델 공급자가 있다면 설정 화면의 모델·공급자 메뉴에서 연결할 수도 있습니다. 터미널에서는 다음 명령으로 같은 설정 창을 열 수 있습니다.
hermes model중요한 보안 원칙도 하나 기억해 두세요. API 키는 채팅창이나 Bot의 SOUL.md에 쓰지 않습니다. Hermes의 Keys 또는 공급자 설정 화면에만 입력하세요. Hermes는 일반 설정을 config.yaml, 비밀값을 .env에 나누어 저장하도록 설계되어 있습니다. Hermes 설정 파일 안내
5단계: 첫 대화로 작동 확인하기
새 채팅을 열고 아래처럼 짧게 입력해 보세요.
안녕하세요. 지금 연결된 모델의 이름을 알려주고,
오늘 할 일을 세 줄짜리 체크리스트로 만들어 주세요.답변이 오면 기본 설치는 끝났습니다.
3. Windows에서 명령어로 설치하는 방법
Desktop 설치가 잘되지 않거나 CLI도 함께 익히고 싶다면 PowerShell을 사용할 수 있습니다.
시작 메뉴에서 PowerShell을 엽니다.
아래 명령을 한 줄 그대로 붙여넣고 Enter를 누릅니다.
iex (irm https://hermes-agent.nousresearch.com/install.ps1)인터넷에서 받은 스크립트를 곧바로 실행하는 명령이므로 주소를 임의의 블로그에서 복사하지 말고 공식 설치 문서의 명령과 같은지 한 번 더 대조하세요.
설치가 끝나면 PowerShell을 닫았다가 다시 열고 다음 명령을 실행합니다.
hermes doctor
hermes --version
hermes desktophermes doctor: 빠진 구성 요소와 설정 오류를 검사합니다.hermes --version: 설치된 버전을 확인합니다.hermes desktop: Desktop 화면을 실행합니다.
hermes라는 명령을 찾을 수 없다는 메시지가 나오면 PowerShell을 완전히 닫고 새로 여세요. 그래도 같다면 컴퓨터를 재시작한 뒤 다시 확인합니다.
4. macOS와 Linux에 설치하기
Apple Silicon Mac
가장 편한 방법은 공식 다운로드 페이지에서 macOS용 Desktop 앱을 받는 것입니다. 공식 페이지는 macOS 12 이상을 안내하고 있으며, 현재 공식 지원표의 Tier 1 대상은 Apple Silicon Mac입니다.
CLI만 설치하고 싶다면 Terminal을 열고 다음 명령을 사용합니다.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc
hermes doctorHomebrew나 PyPI 설치는 현재 공식 지원 경로가 아닙니다. 익숙하다는 이유로 brew install이나 pip install부터 시도하지 않는 편이 좋습니다.
Ubuntu·Debian 계열 Linux
먼저 필요한 기본 패키지를 설치합니다.
sudo apt update
sudo apt install -y git curl xz-utils build-essential그다음 Hermes 설치 명령을 실행합니다.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
hermes doctor
hermes desktopLinux에서 Desktop 화면이 꼭 필요하지 않다면 마지막 명령 대신 hermes만 입력해 터미널 채팅을 시작해도 됩니다.
5. 이제 Bot Mode를 열어 봅시다
Hermes Desktop 왼쪽을 보면 Sessions와 Bots가 나란히 있습니다.
Bots를 클릭하면 만들어 둔 Bot 목록과 현재 활동 중인 Bot, 예약 작업을 관리하는 Routines 영역이 나타납니다.
Bot 하나는 Hermes의 프로필 하나와 같습니다. 모델 설정, 기억, 기술, 도구, 대화 기록이 Bot별로 나뉩니다. 리서치봇에게 가르친 규칙이 글쓰기봇의 대화와 뒤섞이지 않는 이유입니다.
만약 Bots 탭이 보이지 않는다면 다음 순서로 확인하세요.
Settings → Plugins → Bots가 켜져 있는지 봅니다.앱을 업데이트합니다.
터미널에서
hermes doctor를 실행합니다.
6. 첫 Bot 만들기: 교육·입시 리서처
처음부터 Bot 열 개를 만들 필요는 없습니다. 먼저 리서치봇 하나를 제대로 만들어 보겠습니다.
1단계: New Agent 누르기
Bots 화면에서 New Agent를 누릅니다. 빠른 생성 화면에는 Name, Title, Description 세 칸이 나옵니다.
다음 예시를 그대로 바꿔 써도 됩니다.
내부 이름은 영문 소문자와 하이픈으로 짧게 지으면 나중에 @edu-researcher라고 부르기 편합니다. 화면에 보이는 직책과 설명은 한국어로 적어도 됩니다.
2단계: Advanced는 필요한 것만 건드리기
Advanced를 열면 항목이 많아 보이지만 처음에는 아래 네 가지만 확인하면 됩니다.
Create empty는 모든 번들 기술을 빼고 아주 작은 프로필을 만드는 옵션입니다. 무엇이 필요한지 아직 모르는 초보자라면 Fresh profile이 더 편합니다.
3단계: SOUL.md에 업무 규칙 넣기
아래 문장을 Custom SOUL.md에 붙여넣으세요.
너는 리드마스터의 교육·입시 자료 조사관이다.
- 교육부, 한국교육과정평가원, 대학 입학처 등 1차 자료를 먼저 찾는다.
- 사실과 의견을 구분한다.
- 모든 최신 정보에는 발표일과 원문 링크를 붙인다.
- 확인하지 못한 내용은 추측으로 채우지 말고 ‘확인 필요’라고 적는다.
- 결과는 한국어로 쉽고 짧게 요약한 뒤, 활용할 블로그 주제를 제안한다.SOUL.md는 매번 복사하는 프롬프트가 아니라 그 Bot의 상시 업무 수칙입니다. 너무 긴 자료 전체를 넣기보다 “누구인지, 무엇을 먼저 하는지, 무엇을 금지하는지, 어떤 형식으로 보고할지”를 적는 편이 잘 작동합니다.
4단계: Create로 완성하기
생성을 마치면 전용 Bot Chat이 열립니다. 이 대화방은 Bot과 계속 일하는 고정 업무방입니다. 일반 채팅처럼 새 대화를 자꾸 만들기보다 같은 Bot Chat에서 지시하고 결과를 쌓아 가세요.
7. 첫 업무를 맡겨 봅시다
리서치봇에게 다음 요청을 보내 보세요.
최근 14일 안에 발표된 고교학점제와 2028 대입 관련 1차 자료를 찾아 주세요.
교육부·평가원·대학 입학처 자료를 우선하고,
발표일, 핵심 변화, 학부모가 알아야 할 점, 원문 링크 순서로 정리해 주세요.
확인되지 않은 주장은 제외해 주세요.검색 도구가 연결되어 있다면 Bot이 웹을 조사합니다. “검색할 수 없다”는 답이 나오면 Bot이 고장 난 것이 아니라 Web Search 도구가 아직 연결되지 않았을 가능성이 큽니다. Settings의 Tools 또는 터미널의 hermes tools에서 웹 검색 기능을 설정하세요.
결과를 받은 뒤에는 이렇게 후속 지시를 내릴 수 있습니다.
방금 찾은 내용 가운데 리드마스터 블로그 독자에게 가장 유용한 주제 3개만 골라 주세요.
각 주제를 지금 써야 하는 이유도 한 문장씩 붙여 주세요.Bot의 장점은 바로 여기에 있습니다. 다음 날 다시 열어도 자신이 맡은 역할과 같은 Bot Chat의 흐름을 이어 갑니다.
8. 글쓰기봇과 검수봇을 더해 보기
리서치봇이 안정적으로 움직인 뒤 두 Bot을 추가하세요.
한 Bot의 대화에서 다른 Bot을 @이름으로 부르면 일을 넘길 수 있습니다.
@blog-writer 위 조사 결과를 학부모가 이해하기 쉬운 4,000자 내외의 블로그로 작성해 주세요.
첫 문단은 실제 상담 장면으로 시작하고, 원문 링크는 지우지 마세요.초안이 나오면 다시 검수를 요청합니다.
@fact-checker 이 원고의 날짜, 숫자, 기관명, 링크를 검사해 주세요.
근거가 없는 문장은 표시하고 수정안을 제시해 주세요.세 Bot을 한 방에 넣는 그룹 채팅
각 Bot을 따로 오가기가 번거로우면 Bot을 오른쪽 클릭해 Manage groups를 선택하고 새 그룹을 만듭니다. 그룹 채팅에는 2~6개 Bot을 넣을 수 있습니다.
그룹방에서 특정 Bot만 부르지 않으면 여러 Bot이 차례로 의견을 냅니다. 최대 세 차례의 응답 라운드와 한 번의 요청당 10개 메시지 제한이 있어 끝없이 서로 말하는 구조는 아닙니다. 모든 Bot이 매번 답하지 않는 것도 정상입니다. 새로 보탤 내용이 없는 Bot은 조용히 넘어갈 수 있습니다. Bot 그룹 채팅과 Bot 간 메시지 공식 설명
처음에는 그룹 채팅보다 조사 → 작성 → 검수 순서로 한 명씩 부르는 방식이 결과를 확인하기 쉽습니다.
9. Routines로 매일 아침 자동 보고받기
이제 리서치봇이 매일 오전 6시에 새 자료를 찾도록 예약해 보겠습니다.
Desktop 화면에서 만드는 순서
Bots에서edu-researcher를 엽니다.옆의 Routines 영역에서 새 Routine을 만듭니다.
이름은
매일 아침 교육·AI 브리핑으로 적습니다.반복 주기를 매일, 시간은 오전 6시로 설정합니다.
시간대가
Asia/Seoul또는 한국 시간으로 표시되는지 확인합니다.아래 업무 지시를 넣습니다.
지난 실행 이후 새로 나온 교육·입시·AI 교육 자료를 조사하라.
공식 기관과 원문을 먼저 확인하고 중복 기사는 제외하라.
각 항목을 제목, 한 줄 요약, 리드마스터 활용 아이디어, 원문 링크로 정리하라.
새로운 내용이 없으면 없다고 보고하라. 사실을 만들어 채우지 마라.저장한 뒤 Run now 또는 수동 실행으로 한 번 시험합니다.
고급 일정 칸에서 cron 표현식을 쓴다면 매일 오전 6시는 다음과 같습니다.
0 6 * * *Hermes의 예약 작업은 자연어 일정과 cron 표현식을 모두 지원하며 결과는 해당 Bot의 대화 기록에 쌓입니다. Hermes 예약 작업 공식 문서
예약했는데 정해진 시간에 실행되지 않는다면
로컬 설치의 예약 실행은 Hermes gateway가 처리합니다. Desktop 초기 설정에서 이미 서비스가 구성되었을 수 있으니 먼저 상태를 확인하세요.
hermes cron status
hermes cron listgateway 서비스가 없다면 다음 명령으로 사용자 서비스를 설치합니다.
hermes gateway install로컬 컴퓨터가 완전히 꺼져 있으면 그 컴퓨터의 작업도 실행될 수 없습니다. 매일 정해진 시각에 반드시 돌려야 한다면 PC를 켜 두거나 상시 가동하는 서버·Hermes Cloud 같은 원격 환경을 검토해야 합니다.
예약 작업은 실행할 때마다 모델을 호출할 수 있습니다. 처음에는 하루 한 번, 결과 5~10개처럼 작게 시작하세요. 잘 작동하는 것을 확인한 다음 범위와 횟수를 늘리는 편이 비용과 오류를 관리하기 쉽습니다.
10. Bot을 고치고 복제하고 숨기는 법
Bot 목록에서 오른쪽 클릭하면 관리 메뉴를 열 수 있습니다.
Edit Profile: 직책, 설명, 모델, 도구, SOUL.md를 수정합니다.
Duplicate: 설정과 기억, 기술을 포함한 복제본을 만듭니다.
Hide Bot: 목록에서만 감춥니다. 예약 작업과 그룹 소속은 그대로 남습니다.
Delete Profile: 해당 프로필 데이터를 영구 삭제합니다.
Hide와 Delete를 혼동하지 마세요. 잠시 안 보이게만 하려면 Hide를 쓰면 됩니다. Delete는 대화와 기억을 포함한 프로필 데이터를 없애므로 필요한 내용을 먼저 내보내거나 백업하세요. 기본 프로필은 삭제할 수 없습니다.
Bot의 고정 채팅에서 /new나 /reset을 입력하면 Hermes는 관계를 끊는 새 방 대신 /compact로 바꾸어 처리합니다. 오래 쌓인 문맥을 압축하면서도 같은 Bot Chat은 유지하려는 장치입니다.
11. 초보자가 자주 만나는 문제 7가지
① Bots 탭이 없습니다
Settings → Plugins → Bots를 켜고 앱을 다시 확인하세요. 그래도 없으면 업데이트합니다.
hermes update② hermes: command not found가 나옵니다
터미널을 닫았다가 다시 여세요. macOS·Linux라면 셸 설정을 다시 불러옵니다.
source ~/.bashrc
# zsh를 쓴다면
source ~/.zshrc③ API key not set이 나옵니다
모델 공급자가 아직 연결되지 않은 상태입니다.
hermes model키를 채팅창에 붙이지 말고 공급자 설정 화면에 입력하세요.
④ Bot은 답하지만 웹 검색을 못합니다
모델 연결과 검색 도구 연결은 별개입니다. Settings → Tools 또는 다음 명령에서 Web Search를 설정합니다.
hermes tools⑤ Routine이 수동 실행은 되는데 자동 실행이 안 됩니다
gateway와 cron 상태를 확인합니다.
hermes gateway status
hermes cron status
hermes cron list작업 시간대와 다음 실행 시각도 함께 보세요.
⑥ 업데이트 중 Windows 접근 거부 오류가 납니다
Hermes Desktop과 열려 있는 Hermes 채팅을 모두 닫고 gateway를 멈춘 뒤 다시 시도합니다.
hermes gateway stop
hermes update업데이트 뒤에는 hermes doctor로 상태를 검사하세요. 업데이트와 오류 복구 안내
⑦ Bot을 만들수록 결과가 더 엉킵니다
역할이 겹치는 Bot이 너무 많기 때문일 수 있습니다. 처음에는 아래 세 가지만 남겨 보세요.
찾는 사람 → 쓰는 사람 → 확인하는 사람각 Bot의 SOUL.md에서 책임 범위를 분명히 나누고, 한 작업의 최종 책임자는 한 Bot으로 정하는 것이 좋습니다.
12. 초보자를 위한 가장 안전한 시작 순서
첫날에는 설치와 모델 연결만 끝내세요. 둘째 날에는 리서치봇 하나를 만들고 실제 업무 한 건을 맡깁니다. 결과가 마음에 들면 SOUL.md를 조금 고칩니다. 그 다음에 글쓰기봇을 붙이고, 마지막으로 검수봇과 Routine을 추가하세요.
Bot Mode의 매력은 AI를 많이 만드는 데 있지 않습니다. 반복해서 설명하던 업무 원칙을 한 번 정리해 두고, 같은 역할의 AI와 계속 일할 수 있다는 점에 있습니다.
리드마스터의 콘텐츠 작업이라면 다음 구성이 좋은 출발점이 됩니다.
edu-researcher : 교육·입시·AI 원문 수집
blog-writer : 학부모가 읽기 쉬운 블로그 작성
fact-checker : 날짜·수치·링크·과장 표현 검사처음에는 세 Bot을 동시에 움직이지 마세요. 리서치 결과를 직접 한 번 읽고, 글쓰기봇에 넘기고, 검수 결과를 확인해 보세요. 이 작은 흐름이 안정되면 그때 매일 아침 Routine으로 옮기면 됩니다.
AI 자동화는 버튼 하나로 완성되는 마술이 아닙니다. 일을 잘게 나누고, 각 역할의 경계를 정하고, 첫 결과를 사람이 살펴보는 동안 점점 튼튼해지는 작업 방식에 가깝습니다. Hermes Bot Mode는 그 과정을 눈에 보이는 AI 팀으로 만들어 줍니다.
공식 자료 모음
해시태그
#HermesAgent #HermesBotMode #AI에이전트 #AI자동화 #멀티에이전트 #생성형AI #AI도구 #AI설치방법 #초보자튜토리얼 #윈도우AI #AI업무자동화 #AI리서치 #블로그자동화 #콘텐츠자동화 #교육콘텐츠 #입시정보 #리드마스터 #크론잡 #예약작업 #SOULmd
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.