Hermes Agent 설치 메뉴얼 (kimi-k2.5:cloud)

📺 영상 정보

제목: Hermes Agent Full Setup Tutorial: How to Setup Your First AI Agent (Gemma 4)
채널: Nous Research (Hermes Agent 공식 채널)

핵심 내용 (5가지)

① Hermes Agent 설치 방법

Linux / macOS / WSL2 / Android(Termux) 모두 지원
한 줄 명령어로 설치 가능
Windows는 WSL2 필요

② LLM Provider 설정

다양한 AI 모델 제공자 지원 (OpenAI, Anthropic, Gemini, Ollama 등 20+)
최소 64K 토큰 컨텍스트 필요
hermes model 명령어로 쉽게 전환 가능

③ CLI 사용법

hermes - 기본 CLI
hermes --tui - 모던 TUI 인터페이스 (추천)
터미널 명령, 웹 검색, 파일 작업 등 기본 제공

④ 주요 기능

슬래시 커맨드 (/help, /tools, /model, /save 등)
멀티라인 입력 (Alt+Enter 또는 Ctrl+J)
세션 저장 및 재개 (hermes --continue)
음성 모드 지원

⑤ 고급 기능

샌드박스(Docker/SSH) 환경 설정
메시징 플랫폼 연결 (Telegram, Discord, Slack 등)
스킬 설치 및 관리
MCP 서버 연결
cron 작업 예약

실행 가능한 명령어 및 설정 방법

🔧 설치 명령어

# Linux / macOS / WSL2 / Android (Termux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 설치 후 쉘 리로드
source ~/.bashrc  # 또는 source ~/.zshrc

🚀 실행 명령어

hermes           # 기본 CLI 실행
hermes --tui     # 모던 TUI 인터페이스 (추천)
hermes -c        # 마지막 세션 재개

⚙️ 설정 명령어

hermes model     # LLM 제공자 선택
hermes tools     # 도구 설정
hermes setup     # 전체 설정 마법사
hermes doctor    # 문제 진단
hermes update    # 최신 버전 업데이트

🔌 주요 Provider 설정

제공자	설정 방법
Ollama (로컬)	Ollama 설치 후 `hermes model`에서 선택
OpenAI	`hermes model`에서 OAuth 로그인
Anthropic Claude	`hermes model` 또는 ANTHROPIC_API_KEY 설정
Gemini	OAuth 또는 GOOGLE_API_KEY 설정
DeepSeek	DEEPSEEK_API_KEY 설정

🛠️ 샌드박스 설정 (선택)

hermes config set terminal.backend docker  # Docker 격리
hermes config set terminal.backend ssh     # 원격 서버

📱 메시징 플랫폼 연결

hermes gateway setup  # 대화형 설정

🎤 음성 모드 추가

pip install "hermes-agent[voice]"
# 실행 후 /voice on 입력

참고: > ⚠️ 주의: 이 메뉴얼은 참고용이며, 실제 설치는 아직 진행하지 않았습니다.

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

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