헤르메스(Hermes) 에이전트 (나만의 24시간 AI 자동화 비서 구축)

Ⅰ. 헤르메스 에이전트 기술이란?

•  헤르메스 에이전트는 서버 위에서 24시간 쉬지 않고 돌아가는 '맞춤형 AI 자동화 비서'입니다.
• 사용자의 질문에 단순히 답하는 챗봇 수준을 넘어, 일상과 업무의 병목 현상을 스스로 찾아 해결하고 새로운 인사이트를 제공합니다.
• 앱 개발, 이메일 발송, 일정 확인, 데이터 리서치 등 사람이 디지털 환경에서 할 수 있는 거의 모든 작업을 위임하여 처리할 수 있습니다.

Ⅱ. 헤르메스 에이전트 기술 특징

ⅰ. 스스로 발전하는 자율 학습 능력

1. 헤르메스의 가장 강력한 무기는 학습 루프(Learning Loop)입니다. 작업을 수행하면서 발생한 문제와 해결책을 스스로 '스킬(Skill)'로 저장하여 다음 번 동일한 작업 시 더 높은 퍼포먼스를 보여줍니다.
2. '맥락(Context)이 새로운 코드다'라는 최신 AI 패러다임을 채택하여, 한 번의 세팅만으로 시스템이 완전히 자율적으로 학습하고 성장하도록 설계되었습니다.

ⅱ. 기존 AI 도구와의 명확한 차별점

1. 오픈 클로(Open Claw) 대비: 오픈 클로가 여러 채널을 통제하는 무거운 '중앙 컨트롤 센터'라면, 헤르메스는 에이전트 자체의 성장과 작업 수행에 집중하여 훨씬 가볍고 안정적인 운영이 가능합니다.
2. 클로드 코드 / 코덱스 대비: 기존 AI 도구들이 주로 코드 저장소 내부의 '소프트웨어 개발'에 특화되었다면, 헤르메스는 리서치, 브리핑, 자동화 등 그 외의 범용적인 워크플로우 전체를 담당하여 상호 보완적인 시너지를 냅니다.

Ⅲ. 헤르메스 에이전트 기술 동작방식

ⅰ. 멀티 에이전트 플랫폼 기반 워크플로우

1. 초기 단일 에이전트에서 현재는 여러 작업을 동시에 처리할 수 있는 멀티 에이전트 플랫폼으로 진화했습니다.
2. 사용자가 거시적인 목표 하나만 던져주면, 헤르메스가 자체적으로 칸반(Kanban) 보드를 통해 작업을 잘게 나누고 디자인, 코딩, 검수 등 각 에이전트에게 역할을 분담시켜 동시 다발적으로 처리합니다.

ⅱ. 통합된 메모리와 백그라운드 프로세싱

1. 세션 리콜 기능을 통해 사용자와 나눈 과거의 모든 작업 맥락을 세션별로 기억하여 복리 효과를 창출합니다.
2. 대규모 랜딩 페이지 제작이나 데이터 모니터링 같은 무거운 작업은 백그라운드에 돌려놓고, 동시에 사용자와 다른 주제로 대화하는 멀티태스킹이 가능합니다.

Ⅳ. 헤르메스 에이전트 기술 구성 및 흐름도

ⅰ. 아키텍처 및 시스템 흐름

1. 사용자는 텔레그램, 디스코드, CLI 등의 채널을 통해 명령을 내리고, 시스템 데몬(Gateway)이 이를 에이전트 코어로 전달합니다.
2. 에이전트 코어는 LLM(Ollama 등)을 활용해 의도를 분석한 뒤, 내부 메모리, 스킬, 외부 툴을 자율적으로 호출하여 결과를 도출합니다.

 

Ⅴ. 헤르메스 에이전트 기술 설치 방법

ⅰ. 운영 환경 및 인프라 분리 세팅

1. 24시간 가동을 위해 저사양 메인 PC보다는 VPS(가상 사설 서버) 또는 WSL2를 활용한 가상 환경 구축을 권장합니다.
2. 윈도우 환경의 경우 wsl --install -d Ubuntu-24.04 --name hermes 명령어로 별도의 격리된 리눅스 배포판을 생성하여 충돌을 방지합니다.

ⅱ. 에이전트 패키지 설치

1. 우분투 환경에서 설치 스크립트 실행 시 sh 문법 충돌 방지를 위해 아래의 명령어를 사용합니다.

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

   2. 설치 후 hermes doctor 명령어를 통해 Python 가상환경, 필수 패키지, 디렉토리 구조(~/.hermes/)가 정상적으로 구성되었는지 점검합니다.

hermes doctor

ⅲ. 로컬 LLM(Ollama) 프로바이더 연동

1. 비용 효율과 보안을 위해 Ollama를 설치하고 툴 호출(Tool Calling)을 완벽히 지원하는 모델(예: Qwen 3.5 기반)을 다운로드합니다.
2. ChatML 템플릿과 컨텍스트 길이를 명시한 Modelfile을 작성하고 ollama create qwen-hermes -f ~/Modelfile-qwen 명령으로 커스텀 에이전트 모델을 구축합니다.

ⅳ. 메신저 게이트웨이 및 자동 실행 등록

1. 텔레그램 BotFather에서 봇 토큰을 발급받은 후 hermes gateway setup에 접속하여 플랫폼과 토큰, 그리고 인가된 사용자의 User ID(봇 ID 아님)를 등록합니다.
2. 리눅스 systemd user service에 게이트웨이를 등록하고 loginctl enable-linger $USER를 적용하여 컴퓨터 재부팅 시에도 에이전트가 자동 실행되도록 구성합니다.

Ⅵ. 헤르메스 에이전트 기술 사용 방법

ⅰ. 초기 설정 및 시스템 온보딩

1. 처음 사용 시 GPT와 같은 단순 문답이 아닌, 내 비즈니스와 성향에 맞춘 환경 구축이 필요합니다. ~/AGENTS.md 파일에 글로벌 규칙과 사용자 환경을 정의해 둡니다.
2. 조급함을 버리고 매일 하는 반복적인 일(이메일 정리, 일정 알림 등)을 하나씩 에이전트에게 위임하며 지식을 적재하는 기간을 가집니다.

ⅱ. 실생활 및 업무 자동화 적용

1. 스킬 활용: 코드 실행, 이미지 생성, Git 제어 등 내장된 기능을 조합해 커스텀 파이프라인을 구축할 수 있습니다.
2. 오류 모니터링: 서비스 운영 중 에러가 발생하면 실시간으로 감지하고 수정 제안을 받거나 직접 수정을 명령할 수 있습니다.

Ⅶ. 헤르메스 에이전트 기술 자주 쓰는 명령어

ⅰ. 에이전트 제어용 슬래시(/) 명령어

1. /스킨 [테마명]: 인터페이스 테마를 변경합니다. (예: /스킨 웜라이트 모드)
2. /인사이트: 에이전트가 실행한 모든 세션을 분석하고 요약된 통계를 제공합니다.
3. /스틸 [명령]: 에이전트가 작업 중일 때 끼어들어 즉시 방향을 수정합니다. (예: /스틸 불법 편지함에 있는 것만)
4. /바이더웨이 [질문]: 헤르메스의 영구 메모리에 저장되지 않게 일회성 답변만 받고 싶을 때 사용합니다.

ⅱ. 시스템 및 터미널 명령어

1. hermes --tui: CLI 환경에서 직접 에이전트와 대화하는 TUI 모드를 엽니다.
2. hermes -c: 중단되었던 마지막 세션을 이어서 진행합니다.
3. hermes config set model.default <모델명>: 기본 연동 LLM 모델을 변경합니다.
4. journalctl --user -u hermes-gateway -f: 게이트웨이의 실시간 동작 로그 및 에러를 확인합니다.

Ⅷ. 헤르메스 에이전트 기술 활용방안

ⅰ. 일일 모닝 브리핑 자동화

1. 크론(Cron) 스케줄러를 활용해 매일 아침 특정 시간에 이메일, 캘린더, 트위터(X) 실시간 검색 결과를 바탕으로 나만을 위한 요약 리포트를 생성합니다.
2. 시간이 지날수록 나의 관심사를 기억하고 브리핑의 품질이 복리로 향상됩니다.

ⅱ. 마케팅 데이터 추출 및 모니터링

1. 경쟁사의 가격 페이지나 디자인 변경, 특정 유튜브 채널의 동향을 지속적으로 모니터링하고 리뷰를 분석해 불만 사항을 정리하게 할 수 있습니다.
2. 랜딩 페이지 전환율 개선 등 목표를 지정하면 이전 결과를 기반으로 에이전트가 알아서 실험 패턴을 반복 수행합니다.

Ⅸ. 헤르메스 에이전트 기술 트러블 슈팅

ⅰ. 모델 호환성 및 Tool Calling 에러

1. 텔레그램 연동 시 hermes4-14b:latest does not support tools 에러가 발생한다면, 모델 메타데이터가 툴 호출을 지원하지 않는 것입니다. 반드시 Tool Calling이 보장되는 모델(qwen3.5 등)로 교체해야 합니다.
2. Ollama가 모델 목록을 인식하지 못할 때는 systemctl restart ollama 후 모델을 재등록하여 호환 레이어를 깨워야 합니다.

ⅱ. 컨텍스트 길이(Context Window) 충돌

1. "below the minimum 64,000 required" 에러 발생 시, ~/.hermes/config.yaml 파일의 model: 섹션 하위에 context_length: 65536 및 ollama_num_ctx: 32768 등의 오버라이드 옵션을 수동으로 기입하여 해결합니다.

ⅲ. 게이트웨이 인증 및 로그 확인 불가

1. 텔레그램에서 메시지를 보내도 무응답이거나 Unauthorized user 에러가 난다면, Allowlist에 봇의 토큰 ID가 아닌 실제 사용자의 고유 User ID(@userinfobot에서 확인)를 입력했는지 확인합니다.
2. 서비스 에러 시 로그 파일이 생성되지 않는다면, 서비스 설정의 StandardOutput을 journal로 변경하고 journalctl을 통해 디버깅합니다.