Hermes Agent 설치 메뉴얼 (minimax-m2.5:cloud)

Hermes Agent 설치 메뉴얼 (minimax-m2.5:cloud)

📺 영상 정보

제목: How to Set Up Hermes Agent – COMPLETE Step-by-Step Guide
채널: Legend (Legends)

---

핵심 내용 요약

1. Hermes Agent란?

• 로컬 AI 모델 + Telegram + 로컬 웹검색을 연동하는 AI 에이전트
• 100% 프라이빗하게 작동하게 설정할 수 있음
• 메인 컴퓨터가 아닌 별도 기기에 설치 권장 (보안 때문)

2. 로컬 모델 설정 (Ollama)

• Ollama를 다운로드해 로컬 AI 모델 관리
• 추천 모델: Gemma 4 9.6GB (E4B)
  • 7GB 모델은 기본 작업(web search 등) 수행 불가 확인됨
  • 9.6GB 모델에서 정상 작동 확인
• Ollama 기본 URL: http://localhost:11434/v1

3. 텍스트 음성 변환 (TTS)

• 클라우드 TTS 대신 NeovaTTS (로컬) 사용 권장
• 완전히 로컬에서 돌아가는 음성 합성

4. 웹검색 설정 (Firecrawl)

• Firecrawl 클라우드(X) → Self-hosted 선택
• Docker 설치 후 Firecrawl 컨테이너로 실행
• 기본 URL: http://localhost:3002 (Firecrawl 기본값)

5. Telegram 연동

• BotFather에서 봇 생성 → 토큰 복사
• @raw_data_bot 으로 Telegram User ID 확인
• Allowed user ID를 본인 것만 지정 (빈칸이면 누구나 접속 가능)

---

실행 가능한 명령어/설정 정리

1. Hermes Agent 설치

# GitHub에서 설치 명령어 복사 후 실행 (설치 마법사가 자동으로 필요한 패키지 설치)

2. Ollama 모델 다운로드

# Ollama 설치
curl -fsSL https://ollama.com/install.sh | sh

# 모델 다운로드 (Gemma 4 E4B 예시)
ollama pull gemma4-4b

# 설치된 모델 목록 확인
ollama list

3. Hermes 설정 중 사용할 URL/설정값

항목	값
Ollama API Base URL	http://localhost:11434/v1
API Key	(비워두기)
Firecrawl URL	http://localhost:3002
세션 리셋	24시간ごと 또는 비활성 1440분
최대 도구 호출 횟수	기본 60

4. Docker에서 Firecrawl 실행

# Docker 설치 후 (docker.com에서 다운로드)
# Firecrawl 컨테이너 실행 (명령어 vid description 참고)

5. Telegram 봇 생성

1. Telegram에서 @BotFather 검색
2. /newbot 입력 → 봇 이름/사용자명 설정
3. 발급된 토큰 복사

6. Telegram User ID 확인

1. Telegram에서 @raw_data_bot 검색 → Start
2. 표시되는 User ID 복사

7. 기타 Hermes 명령어

hermes      # Hermes 채팅 시작
hermes uninstall   # Hermes 제거 (데이터 보존/완전삭제 선택)

---

참고

• 영상에서 필자는 설정 과정 중 몇 번이고 UI 버그가 발생했다고 언급 (설정 중간에 이전 화면으로 돌아가거나 하는 문제)
• UI 버그 발생하면 Enter 눌러서 스킵, 문제없음 ㅋㅋ
• 시스템 크래시가 나면 hermes 명령어로 다시 시작하면 됨

💡 2026-04-20 업데이트: MiniCITY 환경에서 Ollama는 맥미니에서 구동됨. WSL2에서 사용 시 model.base_url을 http://100.96.177.124:11434/v1로 설정.

[!note] 수정이력 | 2026-04-20 11:01, 미미