imkofty/Hermuse

これは何？

主な機能

• 01単一のスクリプトでUbuntuにHermes Agent、9Router、Node.jsをインストールします。
• 02数値のユーザーIDを使ったallowlistで、TelegramボットをHermesゲートウェイに接続します。
• 03Cloudflare PagesとD1を使ったポーリング型トンネル経由で、ローカルの9Routerダッシュボードを外部に公開します。
• 04supervisorスクリプトとcronのwatchdogにより、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ボットのトークンが必要です。

収録されている特集

トピック

よくある質問

Hermuse とは？

Hermes Agent、9Routerのモデルプロキシ、Telegramボットゲートウェイを、自前のLinuxサーバーやVMで動かすためのスクリプトとガイド。 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