Repolode
제출하기
imkofty

imkofty/Hermuse

개인 Linux 서버나 VM에서 Hermes Agent, 9Router 모델 프록시, Telegram 봇 게이트웨이를 실행하기 위한 스크립트와 가이드입니다.

GitHub에서 보기
스타
155
포크
39
열린 이슈
0
마지막 커밋
15일 전

어떤 프로젝트인가요?

Hermuse는 개인 컴퓨터나 VPS에서 AI 에이전트 스택을 실행하기 위한 셸 스크립트와 문서 모음입니다. Hermes Agent CLI, OpenAI 호환 모델 프록시인 9Router, Telegram 게이트웨이를 함께 제공해 언제든지 개인 AI 봇과 대화하고 브라우저에서 모델 대시보드에 접속할 수 있습니다.

이 저장소에는 Ubuntu 설치 방법, 폴링 클라이언트를 사용해 Cloudflare Pages와 D1을 통해 로컬 대시보드를 외부에 공개하는 Cloudflare 터널, 그리고 9Router·터널 클라이언트·게이트웨이에 문제가 생기면 재시작하는 감독 프로세스가 포함되어 있습니다. 워치독 스크립트는 cron에서 실행되며, 별도의 게이트웨이 워치독은 프로세스가 존재하는지만 확인하는 대신 Telegram 폴링이 멈췄는지 감지합니다.

이 프로젝트는 Linux VM을 대상으로 하며, doctor 스크립트, Telegram 봇의 허용 목록 기반 접근 제어, 자격 증명 교체 및 터널 데이터베이스 마이그레이션 가이드를 제공합니다.

핵심 기능

  • 01스크립트 하나로 Ubuntu에 Hermes Agent, 9Router, Node.js를 설치합니다.
  • 02숫자 사용자 ID 허용 목록을 사용해 Telegram 봇을 Hermes 게이트웨이에 연결합니다.
  • 03Cloudflare Pages와 D1을 사용하는 폴링 터널을 통해 로컬 9Router 대시보드를 외부에 공개합니다.
  • 04감독 스크립트와 cron 워치독으로 9Router, 터널 클라이언트, 게이트웨이를 자동으로 재시작합니다.
  • 05이벤트 루프 하트비트와 어댑터 활동을 사용해 Telegram 폴링이 멈췄는지 감지합니다.
  • 06doctor 스크립트와 터널 데이터베이스 마이그레이션 검사기를 제공합니다.

활용 사례

  • 소형 Linux VPS에서 비공개 Telegram AI 어시스턴트를 실행합니다.
  • 인바운드 포트를 열지 않고도 브라우저에서 접속할 수 있는 자체 관리형 모델 대시보드를 호스팅합니다.
  • 충돌이나 재부팅 후 자동 복구가 필요한 상시 실행 봇을 운영합니다.

빠른 시작

  1. 1

    모든 항목 설치하기(종속 항목, Hermes, 9Router)

    bash scripts/install.sh
  2. 2

    OAuth를 통해 모델 제공업체에 로그인하기

    hermes setup --portal
  3. 3

    Telegram 봇을 연결하고 숫자 ID 허용 목록 설정하기

    hermes gateway setup
  4. 4

    Cloudflare 터널 설치하기(자리 표시자를 프로젝트 이름과 D1 이름으로 바꾸기)

    bash scripts/setup-tunnel.sh <pages-project-name> <d1-name>

사용 전 알아둘 점

  • Linux 서버 또는 VM용으로 설계되었습니다. README에는 macOS 또는 Windows 설정 방법이 없습니다.
  • 설치 스크립트를 실행하려면 비밀번호 없는 sudo 또는 root 권한이 필요합니다.
  • 전체 스택을 사용하려면 Cloudflare 계정과 Telegram 봇 토큰이 필요합니다.

포함된 컬렉션

오픈소스 AI 에이전트 프레임워크와 앱셀프 호스팅 앱AI 챗봇 및 채팅 클라이언트오픈소스 개인 AI 에이전트

토픽

#ai-agent#telegram-bot#self-hosted#cloudflare#llm#automation#openai-compatible#chatbot#hermes-agent#personal-assistant

자주 묻는 질문

Hermuse은(는) 무엇인가요?
개인 Linux 서버나 VM에서 Hermes Agent, 9Router 모델 프록시, Telegram 봇 게이트웨이를 실행하기 위한 스크립트와 가이드입니다. Hermuse는 개인 컴퓨터나 VPS에서 AI 에이전트 스택을 실행하기 위한 셸 스크립트와 문서 모음입니다. Hermes Agent CLI, OpenAI 호환 모델 프록시인 9Router, Telegram 게이트웨이를 함께 제공해 언제든지 개인 AI 봇과 대화하고 브라우저에서 모델 대시보드에 접속할 수 있습니다.
Hermuse은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Hermuse은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Hermuse은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. Hermuse의 마지막 커밋은 2026년 10월 23일입니다.
Hermuse은(는) 어디에 사용할 수 있나요?
소형 Linux VPS에서 비공개 Telegram AI 어시스턴트를 실행합니다. 인바운드 포트를 열지 않고도 브라우저에서 접속할 수 있는 자체 관리형 모델 대시보드를 호스팅합니다. 충돌이나 재부팅 후 자동 복구가 필요한 상시 실행 봇을 운영합니다.
Hermuse는 어떻게 설치하나요?
모든 항목 설치하기(종속 항목, Hermes, 9Router): bash scripts/install.sh OAuth를 통해 모델 제공업체에 로그인하기: hermes setup --portal Telegram 봇을 연결하고 숫자 ID 허용 목록 설정하기: hermes gateway setup Cloudflare 터널 설치하기(자리 표시자를 프로젝트 이름과 D1 이름으로 바꾸기): bash scripts/setup-tunnel.sh <pages-project-name> <d1-name>
Hermuse은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/imkofty/Hermuse

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트