홈 랩 #3: Raspberry Pi 3 Model B+에서 Hermes Agent 실행하기

이 가이드에서는 **Raspberry Pi 3 Model B+**에서 Docker를 사용하여 Hermes Agent를 설치 및 실행하고, 이를 통신 채널로 Telegram에 연결하는 방법을 알아봅니다.

⚠️ 참고: Raspberry Pi 3 B+는 CPU와 RAM이 제한적이므로, Raspberry Pi 4나 x86 서버와 같은 최신 기기만큼 성능이 빠르지 않을 수 있습니다.

🧰 요구 사항

시작하기 전에 다음 사항을 확인하세요:

• Raspberry Pi 3 Model B+
• Raspberry Pi OS (64-bit 권장, 32-bit도 작동 가능)
• Docker 설치됨
• 안정적인 인터넷 연결
• 최소 1–2 GB의 여유 저장 공간
• Telegram 계정

Docker 확인:

docker --version

Docker가 설치되어 있지 않은 경우:

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

그 다음 재부팅:

sudo reboot

📁 1단계 — 데이터 디렉토리 생성

Hermes를 위한 영구 저장소를 생성합니다:

mkdir -p ~/.hermes

⚙️ 2단계 — Hermes 설정 실행

Hermes 설정 마법사를 초기화합니다:

docker run -it --rm \
-v ~/.hermes:/opt/data \
nousresearch/hermes-agent setup

완료될 때까지 설정 지침을 따르세요.

🚀 3단계 — Hermes Gateway 실행

Hermes를 백그라운드 모드로 시작합니다:

docker run -d \
--name hermes \
--restart unless-stopped \
-v ~/.hermes:/opt/data \
-p 8642:8642 \
-p 9119:9119 \
-e HERMES_DASHBOARD=1 \
-e HERMES_DASHBOARD_INSECURE=1 \
-e GATEWAY_ALLOW_ALL_USERS=true \
nousresearch/hermes-agent gateway run

🔍 4단계 — 상태 확인

컨테이너가 실행 중인지 확인합니다:

docker ps

로그 확인:

docker logs -f hermes

🌍 5단계 — Hermes 대시보드 접속

브라우저를 엽니다:

IP 주소 찾기:

hostname -I

📲 6단계 — Telegram 채널 연결

이제 Hermes UI 내부에서 Telegram을 채널로 연결하겠습니다.

1. 먼저 Telegram Bot 생성하기

Hermes를 Telegram에 연결하기 전에:

• Telegram을 엽니다
• BotFather를 검색합니다
• 다음 명령어를 사용하여 새 봇을 생성합니다:

/newbot

• 지침을 따릅니다:
  • 봇 이름 설정
  • 사용자 이름(username) 설정
• BOT TOKEN을 복사합니다 (중요)

2. Hermes 대시보드 열기

다음으로 이동합니다:

필요한 경우 로그인합니다.

3. Telegram 채널 추가

대시보드 내부에서 다음을 수행합니다:

• Channels를 클릭합니다.
• Add Channel을 클릭합니다.
• Telegram을 선택합니다.

그 다음 다음 정보를 입력합니다:

• Bot Token → BotFather로부터 받은 토큰을 붙여넣습니다.
• Allowed Users → 봇과 상호작용할 수 있도록 허용된 Telegram 사용자 ID 또는 사용자 이름(username)

여기에 나열된 사용자만이 Hermes 봇에 접속하고 사용할 수 있습니다.

4. 저장 및 연결

Save / Connect를 클릭합니다.

성공했을 경우:

• Telegram 채널 상태가 Connected로 변경됩니다.
• 봇이 Hermes 게이트웨이를 통해 응답을 시작합니다.

⚠️ 중요 참고 사항

• 연결하기 전에 항상 BotFather를 통해 봇을 생성해야 합니다.
• 봇 토큰을 비공개로 유지하세요 (노출하지 마세요).
• Raspberry Pi가 접근 가능한 상태인지, 또는 필요한 경우 네트워크/터널을 통해 노출되어 있는지 확인하세요.
• Telegram 사용자들은 Hermes UI에서 정확하게 화이트리스트(whitelist)에 등록되어야 합니다.

🧼 Hermes 중지 또는 제거

컨테이너 중지:

docker stop hermes

컨테이너 제거:

docker rm hermes

🎯 결론

이제 다음을 갖추게 되었습니다:

• Raspberry Pi 3 Model B+에서 실행되는 Hermes Agent
• 브라우저를 통해 접속 가능한 대시보드
• 성공적으로 통합된 Telegram 채널

이 설정을 통해 Telegram에서 직접 홈 랩(home lab) AI 에이전트와 상호작용할 수 있습니다.

다음 업그레이드 단계를 원하신다면:

• 외부 접속을 위한 Cloudflare Tunnel 추가
• WhatsApp 채널 통합
• 여러 개의 에이전트 연결
• 또는 완전한 AI 자동화 홈 랩 스택 구축