2026年 Hermes Agent Mac版
最新セットアップチェックリスト：週末に手を動かす前に用意すべきこと

お試しだけなら 公式 Quickstart で十分です。Mac 上で Hermes を長く使いたいなら、下の項目を先にチェックしてからインストールコマンドを打ちましょう。

1. インストール前：ハードウェア・システム・バックアップ

2. 依存関係の準備：公式が求めるのは Git のみ

Installation によると、一行インストーラが uv、Python 3.11、Node.js v22、ripgrep、ffmpeg を自動処理します。Homebrew 版 Python/Node を先に入れる必要はありません。事前に確認するのは Git だけです：

• ①Git：git --version が通れば OK。途中で CLT インストールに止まらないように。
• ②Shell：デフォルト zsh。インストール後は source ~/.zshrc で PATH を反映。
• ③Nix（任意）：Nix ユーザーは Nix ドキュメント を参照。curl インストールとどちらか一方を選択。

3. アカウントとシークレット

セットアップ中に LLM プロバイダを選びます。先に用意しておくと中断が減ります：

• ①OpenRouter / Anthropic / OpenAI など、少なくとも 1 つの API キー。
• ②キーは ~/.hermes/.env に保存し、chmod 600 ~/.hermes/.env を実行。
• ③Git リポジトリにキーを入れない。Gateway は TELEGRAM_ALLOWED_USERS 等でホワイトリスト化し、GATEWAY_ALLOW_ALL_USERS=true は避ける。

4. 安全なワークスペース

公式の per-user レイアウト：コードは ~/.hermes/hermes-agent/、データは ~/.hermes/（config、logs、pairing、sandboxes）。

• ①エージェント用の専用サブディレクトリを使い、ホーム全体を丸ごと渡さない。
• ②ログ：~/.hermes/logs/（Gateway は gateway.log）。
• ③カスタムパス：HERMES_INSTALL_DIR=... を設定してからインストールスクリプトを実行（公式ドキュメント参照）。

5. インストールと初回検証

Install（最小構成）：

続けて source ~/.zshrc → hermes または hermes setup → hermes model。

First run 検証：

• ✓which hermes → ~/.local/bin/hermes
• ✓hermes doctor にブロッキング項目がない（API キー不足なら hermes model へ）
• ✓実際の会話を 1 件送り、モデル応答とツール呼び出しを確認
• ✓ファイル/ターミナルツールを使う場合、システム設定で「フルディスクアクセス」等を付与

6. 常駐運用：launchd で再起動後も生き残る

CLI で hermes を起動しただけでは現在のセッション限定です。Messaging Gateway はデーモン化が必要です：

• 1CLI が安定したら hermes gateway setup（Telegram / Discord / Slack 等は公式 Messaging ドキュメントの対応一覧を確認）
• 2hermes gateway install → plist：~/Library/LaunchAgents/ai.hermes.gateway.plist
• 3hermes gateway start → hermes gateway status
• 4ログ：tail -f ~/.hermes/logs/gateway.log
• 5後から Homebrew/nvm でツールを追加したら、hermes gateway install を再実行して plist の PATH を更新

7. 復旧：失敗時の優先順位

8. 24 時間観察チェックリスト

• ①Mac を再起動 → hermes gateway status が running のままか
• ②5 分間オフラインにして復帰。Gateway が自復旧するか、手動 start が必要か
• ③~/.hermes/logs/ に異常スタックがないか spot チェック
• ④LLM 請求を確認。ツールループによるコスト急増がないか
• ⑤危険コマンドを意図的に 1 回トリガーし、承認フローが生きているか

9. Mac mini なら Agent を 7×24 で回しやすい

Hermes の Gateway、BlueBubbles ブリッジ、ローカルツールチェーンは、安定した macOS 環境に依存します。Mac mini M4 は Apple Silicon の統合メモリと約 4W 級の待機電力で、家庭や小チームの静音 Agent ノードに向きます。ネイティブ Unix、Homebrew、Docker、launchd が WSL なしで揃い、Gatekeeper と FileVault が長期露出面を抑えます。同価格帯の Windows ホストよりクラッシュ率が低く、無人 Gateway 運用に適しています。

週末に入れて来週から常時オンラインにしたいなら、Mac mini M4 はコスパの良い出発点です。今すぐホストを整え、Hermes を長期運用向けのハードで動かしましょう。