Hermes Agent 입문 가이드 — 텔레그램으로 조작하는 오픈소스 AI 에이전트 (2026)

결론부터 얘기하면, Hermes Agent는 자기 서버나 컴퓨터에 설치해서 텔레그램·디스코드 같은 메신저로 조작하는 오픈소스 AI 에이전트야. Nous Research가 만들었고 MIT 라이선스로 공개돼 있어. 설치는 커맨드 한 줄이면 끝나.

한눈에 정리

· 개발: Nous Research
· 라이선스: MIT (오픈소스)
· 공식 저장소: github.com/NousResearch/hermes-agent
· 지원 OS: Linux, macOS, WSL2 (Windows 네이티브 미지원)
· 메신저 연결: Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant
· 모델 공급자: Nous Portal, OpenRouter(200+), OpenAI, Anthropic, z.ai/GLM, Kimi/Moonshot, MiniMax, 자체 엔드포인트
· 특징: 영구 메모리, 자동 스킬 생성, 음성 모드, MCP 지원

Hermes Agent가 뭔가

heremes agent

https://hermes-agent.nousresearch.com/

Hermes Agent — The Agent That Grows With You

 

자기 컴퓨터나 서버에 설치해서 쓰는 자율 AI 에이전트야. 공식 태그라인은 "The agent that grows with you(너랑 함께 성장하는 에이전트)"로, 쓸수록 경험을 스킬로 저장하고 다음에 비슷한 작업이 오면 저장된 스킬을 꺼내 쓴다는 개념이야.

보통 챗봇은 질문하면 답하고 세션이 바뀌면 기억이 초기화돼. Hermes는 서버에서 상시 돌아가며 영구 메모리를 유지하고, 반복된 작업은 자동으로 스킬로 저장해.

일반적인 코딩 보조 도구(Claude Code 같은)와는 포지션이 달라. Claude Code는 IDE 안에서 개발자랑 함께 코드를 짜는 도구야. Hermes는 서버에 상주하면서 메신저로 조작하는, "내가 없어도 돌아가는" 에이전트라는 결이 달라.

설치하기 전에 확인할 것

운영체제 호환

공식 지원은 Linux, macOS, WSL2(Windows Subsystem for Linux) 세 가지야. 순수 Windows 환경은 공식적으로 지원하지 않아. Windows 사용자라면 WSL2를 먼저 설치하거나, 클라우드 서버에 올리는 방식을 고려해야 해.

설치 위치 선택

크게 세 가지 선택지가 있어.

1. 로컬 머신 (본인 맥 또는 리눅스)
장점: 설치 쉽고 비용 없음
단점: 컴퓨터 꺼지면 에이전트도 멈춤

2. VPS (가상 서버)
장점: 24시간 상시 실행, 어디서든 접속 가능
단점: 월 서버 비용 발생 (공식 문서에 따르면 $5 수준의 저가 VPS에서도 동작)

3. 서버리스 (Daytona, Modal)
장점: 미사용 시 하이버네이션, 요금 최소화
단점: 초기 설정 난이도 있음

상시 텔레그램으로 일 시키고 싶으면 VPS가 일반적인 선택이고, 단기 체험용이라면 로컬이 편해.

설치 단계

1단계 — 설치 커맨드 실행

공식 저장소(github.com/NousResearch/hermes-agent)에 단일 설치 커맨드가 있어. 터미널에 붙여넣으면 Python, Node.js, 의존성, hermes 커맨드까지 자동으로 잡아줘. 공식 안내에 따르면 git 외에는 사전 요구사항이 없어.

2단계 — 셋업 마법사

설치 후 hermes setup 을 실행하면 마법사가 떠. 어떤 모델 제공자를 쓸지, 어떤 메신저를 연결할지 대화형으로 고르면 돼.

3단계 — 모델 제공자 선택

모델은 언제든 hermes model 로 바꿀 수 있어. 공식에서 명시하는 공급자는 다음과 같아.

· Nous Portal — Nous Research 자체 포털
· OpenRouter — API 키 하나로 200개 이상의 모델 접근
· OpenAI, Anthropic — 직접 연결 (Claude Code 자격증명 자동 인식 지원)
· z.ai/GLM, Kimi/Moonshot, MiniMax — 개별 제공자
· 자체 엔드포인트 — OpenAI 호환 API면 연결 가능 (로컬 모델 포함)

선택한 모델은 /model 슬래시 커맨드로 대화 중에도 즉시 전환할 수 있어.

4단계 — 메신저 연결

텔레그램, 디스코드, 슬랙, 왓츠앱, 시그널, 이메일(IMAP/SMTP), Home Assistant까지 공식 지원이야. 텔레그램이 문서화가 가장 잘 돼있고 봇 토큰 발급도 간단해서 첫 연결로 많이 선택해.

hermes gateway setup → hermes gateway start 순서로 게이트웨이를 띄우면, 해당 메신저에서 봇한테 메시지 보내는 것만으로 에이전트에 일을 시킬 수 있어.

주요 기능 훑어보기

공식 문서에 명시된 핵심 기능을 간단히 정리하면:

· 자동 스킬 생성 — 복잡한 작업을 완수하면 에이전트가 스스로 스킬 문서를 만들어 저장
· 영구 메모리 — 세션이 끊어져도 사용자 모델·과거 대화 맥락을 유지
· MCP 클라이언트 — Model Context Protocol 지원, 외부 도구 확장
· 음성 모드 — CLI에서 푸시투토크, Telegram·Discord 음성 메모 처리 (로컬 Whisper 사용)
· 서브에이전트 위임 — 병렬 작업을 별도 컨텍스트로 분리 실행
· PII 레닥션 — 개인정보 스크러빙 옵션 (privacy.redact_pii)
· ACP 서버 — VS Code, Zed, JetBrains에서 Hermes를 에이전트 백엔드로 연결
· 플러그인 아키텍처 — ~/.hermes/plugins/ 에 Python 파일 드롭으로 도구·커맨드 확장

어떤 사람한테 맞나

맞는 경우

반복 작업을 에이전트한테 맡기고 싶은 경우. 매일 정해진 시간에 리포트 받기, 특정 사이트 변화 감지, 장시간 돌아가는 데이터 처리 같은 작업은 "서버에 상주하는 에이전트" 포지션이 적합해. 여러 기기에서 같은 에이전트에 접근하고 싶을 때도 잘 맞아.

맞지 않는 경우

IDE 안에서 코드 짜는 게 주목적이면 Claude Code 같은 도구가 더 직관적이야. 단순 Q&A용이면 ChatGPT·Claude.ai 웹 인터페이스로 충분하고. 서버를 관리할 의사가 없다면 진입 난이도가 있을 수 있어.

입문자가 자주 막히는 지점

Q. Windows에서 그냥 설치 못하나?
네이티브 설치는 공식적으로 지원 안 해. WSL2를 먼저 설치해서 리눅스 환경을 만든 뒤 그 안에서 설치해야 해.

Q. 유료인가?
Hermes 자체는 MIT 오픈소스라 무료야. 실제 비용은 (1) 서버 임대료(VPS 쓸 경우) (2) 모델 API 비용(OpenAI·Anthropic 등 유료 모델 연결 시) 두 가지가 있어. 각 모델 공급자의 요금 체계는 공급자 공식 페이지에서 따로 확인해야 해.

Q. 개발 몰라도 쓸 수 있나?
설치·셋업은 명령어 몇 개 따라치면 되는 수준이야. 다만 VPS 관리나 오류 대응은 어느 정도 리눅스 기본기가 있는 게 편해. 완전 초보라면 로컬 맥/리눅스에 먼저 설치해보고, 감 잡은 뒤 서버로 옮기는 순서가 무난해.

Q. 한국어 되나?
연결하는 모델에 따라 달라져. Claude, GPT 같은 상용 모델은 한국어 처리 수준이 높고, 에이전트 명령은 자연어로 어느 언어든 가능해.

Q. 데이터가 외부로 나가나?
Hermes 본체는 자기 서버에서 돌아가니까 에이전트 로직·메모리는 로컬에 남아. 다만 연결한 모델 공급자(OpenAI, Anthropic 등) 서버로는 프롬프트가 전송돼. 데이터 민감도가 높다면 로컬 모델 엔드포인트를 붙이는 옵션을 검토해볼 만해. 참고로 Hermes에는 개인정보를 자동 스크러빙하는 PII 레닥션 옵션도 있어.

정리

Hermes Agent는 "내 서버에 사는 AI 에이전트"가 필요한 사람에게 적합한 오픈소스 도구야. 설치 장벽이 낮고, 텔레그램 같은 메신저로 어디서든 조작할 수 있어. 메모리와 스킬이 누적되는 구조라 쓸수록 내 환경에 맞게 학습한다는 점이 일반 챗봇과 가장 큰 차이야.

처음 써본다면 로컬이나 저가 VPS에 올려보고, 익숙해진 뒤 자기 업무에 어떻게 녹일지 설계하는 순서를 권해. 아직 빠르게 발전하는 프로젝트니까 공식 문서를 수시로 확인하면서 접근하는 게 좋아.

나는 손해사정 업무를 하면서 AI 도구들을 실무에 어떻게 활용할지 실험하고 있어. 구체적인 적용 사례는 후속 글에서 풀 예정이야.

참고 자료
· 공식 저장소: github.com/NousResearch/hermes-agent
· 공식 문서: hermes-agent.nousresearch.com/docs

※ 이 글은 발행 시점의 공식 저장소·문서를 기준으로 작성됐어. 기능과 명령어는 업데이트에 따라 달라질 수 있으니 실행 전 공식 문서 확인을 권해.

손해사정 관련 상담이 필요한 경우 아래 명함으로 연락 주세요.