Hermes Agent 설치 메뉴얼 (glm-5.1:cloud)

Hermes Agent 설치 메뉴얼 (glm-5.1:cloud)

📺 영상 분석 결과

1. 영상 제목 및 채널명

• 제목: Hermes Agent Full Setup Tutorial: How to Setup Your First AI Agent (Gemma 4)
• 채널명: (YouTube 페이지에서 채널명이 직접 추출되지 않았으나, 영상 내용상 AI 에이전트 튜토리얼 채널)

---

2. 핵심 내용 요약 (5개)

1. Hermes Agent 설치 및 기본 설정

   • GitHub에서 설치 명령어 복사 후 터미널에서 실행
   • 메인 PC 대신 별도 기기(전용 디바이스) 에 설치 권장 — 보안상 이유 (비밀번호, 뱅킹 앱 등 접근 위험)
   • Quick Setup / Full Setup 중 Full Setup 선택

2. Ollama로 로컬 AI 모델 구동

   • Ollama 설치 후 ollama pull gemma4:e4b 명령으로 Gemma 4 E4B(9.6GB) 모델 다운로드
   • E2B(7GB) 모델은 기본 작업(웹 검색 등)에 실패 → E4B 이상 권장
   • API Base URL: http://localhost:11434/v1
   • GPU 부족한 경우 Ollama 클라우드 ($20/월)도 가능

3. Telegram 봇 연동

   • BotFather에서 /newbot → 봇 생성 → 토큰 복사
   • raw_data_bot으로 자신의 Telegram User ID 확인 → 접근 권한 제한
   • 홈 채널로 자신의 User ID 설정

4. Firecrawl 자체 호스팅으로 로컬 웹 검색 구축

   • Docker 설치 필수
   • Firecrawl self-hosted 버전을 Docker 컨테이너로 실행
   • 기본 URL: http://localhost:3000 (Hermes 설정에 입력)
   • 클라우드 유료 대신 완전 무료 + 프라이빗 구성

5. 주요 설정값 및 팁

   • 최대 툴 호출 반복: 60 (기본값)
   • 컨텍스트 압축: 0.5 (소형 모델용)
   • 세션 리셋: 비활성 시 자동 또는 매일 04:00 리셋 권장 (컨텍스트 누적 방지)
   • 툴 진행 표시: All (디버깅/최적화에 유리)
   • TTS: NEUTTS (로컬)

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

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

---

3. 실행 가능한 명령어 & 설정 방법 정리

Ollama 설치 & 모델 다운로드

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

# Gemma 4 E4B 모델 다운로드
ollama pull gemma4:e4b

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

Hermes Agent 설치

# GitHub에서 설치 명령어 복사 후 실행 (영상 설명란 참고)
# Full Setup 선택 → 모델 설정 → 채널 설정 순서

Hermes Agent 모델 설정

• API Base URL: http://localhost:11434/v1
• API Key: (로컬이면 빈 값, Enter)
• Model: gemma4:e4b (Ollama list에서 확인한 이름)
• Context Length: 자동 감지 (Enter)

Docker + Firecrawl 자체 호스팅

# Docker 설치 후 (docker.com에서 다운로드)
# 영상 설명란의 Firecrawl 설치 명령어 실행
# Docker 앱에서 Firecrawl 컨테이너 실행 확인

• Firecrawl URL (Hermes 설정): http://localhost:3000

Telegram 봇 설정

1. Telegram → BotFather → /newbot
2. 봇 이름: 원하는 이름 (예: Hermes demo)
3. 유저네임: 원하는이름_bot
4. 발급된 토큰 → Hermes 설정에 붙여넣기
5. Telegram User ID → raw_data_bot에서 /start 후 확인
6. 홈 채널 = 자신의 User ID로 설정

Hermes 관리 명령어

# 설정 변경 / 모델 교체 / 툴 추가
# (GitHub의 명령어 목록 참고)

# Hermes 완전 삭제
hermes uninstall
# 옵션 1: 데이터 보존 삭제
# 옵션 2: 완전 삭제

주의사항

• 전용 기기 사용 권장 (메인 PC 보안 위험)
• 소형 모델은 세션 리셋 필수 (컨텍스트 누적 → 성능 저하)
• 설정값은 며칠 써보고 조정 — 처음부터 완벽 맞출 필요 없음