Hermes Agent

Hermes Agent は Nous Research が開発した自律型 AI エージェントです。永続メモリ、40 以上の組み込みツール、スケジュール実行、マルチプラットフォームメッセージングに対応しています。

クイックスタート

1. このテンプレートをデプロイ — Zeabur AI Hub キーを生成し、Dashboard ドメイン（例：my-hermes）を入力します。これだけで、エージェントと Dashboard はそのまま使えます。
2. Dashboard を開く — あなたのドメインにアクセスします（Dashboard に自動でバインドされます）。後からネットワークタブでカスタムドメインも設定できます。
3. ログイン — ユーザー名 admin、パスワードはサービスの PASSWORD（サービス説明に表示）。ブラウザで直接チャットできます — Telegram は不要です。

OpenRouter、他のプロバイダー（Minimax、Kimi など）、または Telegram を使いたい場合は、デプロイ後に対応する環境変数を追加してください — 下記のモデルとプロバイダーおよびメッセージプラットフォームを参照してください。

ポートとドメイン

このサービスは 2 つの HTTP ポートを提供します：

ポート	Id	用途	ドメイン
9119	web	ウェブ Dashboard（標準で有効・ログイン保護付き）	サービスのメインドメイン — 開いてログイン
5000	api	OpenAI 互換 API サーバー	外部 API アクセスが必要な場合のみドメインをバインド

メッセージングプラットフォーム（Telegram、Discord、Slack など）はアウトバウンド接続を使用するため、公開 URL やポートの開放は不要です。

ウェブ Dashboard を使用する

Dashboard は標準で有効で、ログイン保護されています。サービスのドメイン（web ポート）を開いてログインします：

• ユーザー名：admin
• パスワード：サービスの PASSWORD 値（サービス説明に表示）

無効にするには、変数タブで HERMES_DASHBOARD を false に設定します。認証情報を変更するには HERMES_DASHBOARD_BASIC_AUTH_USERNAME ／ HERMES_DASHBOARD_BASIC_AUTH_PASSWORD を設定します。

セキュリティに関する注意： Basic 認証のログインは信頼できるネットワーク内のバックエンド向けです。公開インターネットでより強固に保護するには OAuth（HERMES_DASHBOARD_OAUTH_CLIENT_ID）またはセルフホスト OIDC（HERMES_DASHBOARD_OIDC_*）を使用してください（環境変数リファレンスを参照）。

OpenAI 互換 API を使用する

ネットワークタブで api ポート（5000）にドメインをバインドし、自動生成された API キー（サービス説明に表示）でリクエストを送信：

curl https://YOUR_API_DOMAIN/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "default", "messages": [{"role": "user", "content": "Hello!"}]}'

メッセージプラットフォーム

メッセージングは任意です — デフォルトではウェブ Dashboard で操作します（プラットフォームは不要）。Telegram を接続するには、変数タブで TELEGRAM_BOT_TOKEN（@BotFather から取得）と TELEGRAM_ALLOWED_USERS（@userinfobot から取得するあなたの Telegram ユーザー ID）を追加し、サービスを再起動します。Hermes は 14+ のプラットフォーム（Discord、Slack、WhatsApp、Signal、Matrix、Email、WeChat、WeCom、Feishu、DingTalk、QQ Bot、Mattermost、BlueBubbles/iMessage、SMS、Home Assistant、汎用 webhook）に対応しており、いずれもデプロイ後にその環境変数を設定するだけで有効化できます。

詳細は公式 Messaging Gateway ガイドをご覧ください。

モデルとプロバイダー

このテンプレートは標準で Zeabur AI Hub（キーは「Zeabur AI Hub キー」変数から）、モデル claude-sonnet-4-5、リージョン sfo1 を使用します。変更するには、変数タブで以下を追加して再起動してください：

• モデル — LLM_MODEL を任意の AI Hub モデルに設定します。
• リージョン — 東京を使う場合は LLM_BASE_URL を https://hnd1.aihub.zeabur.ai/v1 に設定します（デフォルトは sfo1）。
• OpenRouter を使う — OPENROUTER_API_KEY を設定します（AI Hub キーは空のままに）。Hermes が自動検出します。
• 他のプロバイダー（Minimax、Kimi、GLM/Zhipu、Gemini、NVIDIA、xAI など）— そのプロバイダーの API キー環境変数（例：KIMI_API_KEY、MINIMAX_API_KEY）を追加し、Exec タブで hermes model を使ってモデルを選択します。Configuration ガイドと環境変数リファレンスを参照してください。

LLM_MODEL ／ LLM_BASE_URL と AI Hub キーは、起動のたびに /opt/data/config.yaml の model ブロックに適用されます。config.yaml を手動で管理したい場合は空欄のままにしてください。

設定

• LLM プロバイダー、ツール、その他の設定 — 公式 Configuration ガイドと環境変数リファレンスを参照してください。
• Zeabur の「ファイル」タブで /opt/data/ 内の設定ファイルを編集：
  • config.yaml — モデル選択、ターミナルバックエンド、プラットフォーム設定
  • SOUL.md — エージェントの性格とシステムプロンプト
  • .env — すべての環境変数
• 編集後、サービスを再起動して変更を適用してください。

CLI 操作

Zeabur の Exec タブ（または zeabur service exec）から Hermes CLI を直接使用できます：

コマンド	説明
hermes	対話型チャット（REPL）
hermes --tui	モダンターミナル UI
hermes -z "prompt"	ワンショットクエリ（スクリプト向け）
hermes status	全コンポーネントのステータス表示
hermes model	モデル／プロバイダーの切り替え
hermes config	設定の表示・編集
hermes sessions list	会話履歴の一覧
hermes -c	前回の会話を再開
hermes cron	スケジュールジョブの管理
hermes skills	スキルの閲覧・インストール

hermes --help で全コマンド一覧を表示できます。

注意事項

• Docker イメージは約 1.3 GB（ダウンロードサイズ）。初回デプロイは通常 1 分以内に取得が完了し、以降のデプロイはキャッシュ済みイメージを再利用します。
• 初回起動時、設定ファイルの初期化とスキル同期に 30〜60 秒かかります。
• ブラウザツールの使用によりメモリ使用量が増加する場合があります。OOM（メモリ不足）エラーが発生した場合は、より大きなインスタンスへのアップグレードをお勧めします（推奨 4 vCPU / 8 GB RAM）。

ライセンス

Hermes Agent は Nous Research により MIT ライセンスで公開されています。