praveen-ks-2001/hermes-agent-template

Hermes Agent – Railway 템플릿

이것은 무엇인가 – 오픈소스 Hermes Agent(Nous Research의 자율 LLM 기반 AI 어시스턴트)를 실행하는 즉시 배포 가능한 Railway 템플릿입니다. 이 템플릿은 LLM 공급자, 메시징 채널(Telegram, Discord, Slack 등), 도구를 구성하고 구성 파일을 편집하지 않고도 Hermes 게이트웨이를 관리할 수 있는 웹 기반 관리 UI를 추가합니다.

주요 기능

• 배지 버튼을 통한 Railway 원클릭 배포.
• LLM 공급자 선택, 채널 활성화, 도구 토글, 게이트웨이 제어(시작/중지/재시작)를 위한 관리 대시보드(/setup).
• 통합 Hermes UI(/) – 기본 Hermes 웹 인터페이스(채팅, 키, 스킬, 분석, 콘솔)가 동일한 로그인 뒤에 프록시됩니다.
• 사용자 페어링 – 수신 메시지가 페어링 요청을 생성하며, 대시보드에서 승인/거부할 수 있습니다.
• 실시간 상태 및 로그 – 게이트웨이 가동 시간, 모델, 대기 중인 요청을 확인하고 브라우저에서 로그를 스트리밍합니다.
• 백업 및 복원 – 전체 /data/.hermes 디렉토리(구성, 자격 증명, 채팅 기록, 스킬)를 6시간 동안 다운로드할 수 있는 zip으로 스냅샷합니다.
• 비밀번호 보호 관리 액세스(쿠키 기반 로그인, 기본 사용자 admin).
• 영구 저장소 – /data에 Railway 볼륨을 연결하여 재배포 시 구성이 유지됩니다.

시작하는 방법

1. LLM 키 얻기 – OpenRouter(또는 기타 지원 공급자)에 가입하고 API 키를 복사합니다.
2. Telegram 봇 생성 – @BotFather와 대화하고 /newbot을 실행한 후 봇 토큰을 복사합니다.
3. 배포 – Deploy on Railway 버튼을 클릭하고 ADMIN_PASSWORD를 설정(또는 시스템이 생성하도록 허용)하고 /data에 마운트된 볼륨을 연결합니다.
4. 구성 – 앱 URL을 열고 로그인(admin / 비밀번호)한 후 /setup으로 이동하여:
   • 공급자(예: OpenRouter)를 선택하고 키/모델을 붙여넣습니다.
   • Telegram을 활성화하고 봇 토큰을 붙여넣습니다.
   • Save & Start를 클릭합니다.
5. 사용 – Telegram 봇에 메시지를 보내면 첫 메시지가 대시보드에 페어링 요청으로 나타납니다. 승인하고 채팅을 시작합니다.

지원되는 공급자 및 채널

• 공급자 – OpenRouter, Anthropic, Google AI Studio, xAI, DeepSeek, Qwen Cloud, GLM, Kimi, NVIDIA NIM, Fireworks AI, AWS Bedrock, Azure Foundry, Ollama Cloud, 9Router, OmniRoute, 모든 OpenAI 호환 엔드포인트 등.
• 채널 – Telegram, Discord, Slack, WhatsApp, Email, Mattermost, Matrix.
• 도구 통합 – 웹 검색(Parallel, Tavily, Perplexity 등), 스크래핑(Firecrawl), 이미지 생성(FAL), 브라우저 자동화(Browserbase), GitHub, 음성(Whisper/TTS), 메모리(Honcho) 등.

한눈에 보는 아키텍처

Railway 컨테이너 (포트 $PORT)
 └─ server.py (Starlette + Uvicorn) – /login, /setup, /health 처리, 기본 Hermes UI로 / 프록시
     ├─ hermes-dashboard (127.0.0.1:9119에서 수신) – 프록시를 통해서만 접근 가능
     └─ hermes-gateway – Telegram/Discord 등과 통신하는 실제 에이전트 프로세스

게이트웨이는 server.py에 의해 감독되며, 충돌 시 자동으로 재시작됩니다.

로컬에서 실행

docker build -t hermes-agent .
docker run --rm -it -p 8080:8080 \
  -e ADMIN_PASSWORD=changeme -v hermes-data:/data hermes-agent

http://localhost:8080을 방문하고 admin / changeme로 로그인합니다.

업데이트 – 템플릿은 HERMES_REF 빌드 인수(기본값 v0.22.2)를 통해 특정 Hermes 릴리스를 고정합니다. 업그레이드하려면 일치하는 release/<version>/<n> 브랜치를 배포하거나 HERMES_REF를 재정의합니다(후자는 기존 볼륨을 손상시킬 수 있음). 버전을 변경하기 전에 항상 /data 볼륨을 백업하세요.

누가 사용할 수 있나요 – 최소한의 운영 노력으로 자체 호스팅 자율 AI 어시스턴트를 원하는 개발자나 취미 사용자, 특히 Railway의 간단한 배포 모델과 채널, 도구, 사용자 액세스 관리를 위한 웹 UI를 선호하는 사용자에게 적합합니다.

---

크레딧 – Hermes Agent by Nous Research; UI는 OpenClaw Railway 관리 템플릿에서 영감을 받았습니다.