セットアップガイド

2026 Hermes Agent 完全
インストール＆設定ガイド：実戦ケースで通し切る丁寧チュートリアル

nuzcloud 編集部 2026-05-23 9 分

この記事で分かること

インストール手順だけでは、Hermes Agent が本当に使えるか判断できません。本記事は低リスクの文書処理ケースを先に定義し、2026 年 Mac 版の完全インストール・設定を「環境準備 → インストール → 設定 → 検証 → 実行 → 排障」の順で通します。独立したテストフォルダでサンプルテキストを読み、要約と ToDo を生成し、結果ファイルを書き出し、~/.hermes/logs/ で全過程を追跡します。（2026-05-23 時点で確認。モデル名・料金は各 provider の最新ドキュメントに従ってください。）

起動成功は第一歩に過ぎません。本当に重要なのは、モデルが応答するか、ファイルが境界内で読み書きできるか、ログが追跡可能か、失敗時に原因を特定できるかです。ここでの実戦ケースは workflow 専門記事ではなく、インストールと設定が本当に機能することを証明する手段です。通過後に本番 Hermes Agent workflow へ拡張できます。

1まず実戦ケースを定義する

最初のケースは低リスク・可逆・検証可能である必要があります。初日から本番リポジトリやプライベートフォルダに触れないでください。

要素	本チュートリアルの固定プラン	合格基準
テストディレクトリ	`~/hermes-lab/`（`rm -rf` でいつでも削除可）	Agent の読み書きはここだけ
入力	`input/notes.md`（自分で書いた 3〜5 段落の議事メモ）	CLI がファイル全体を読める
出力	`output/summary.md` + `output/todos.md`	両ファイルが存在し内容が妥当
ログ	`~/.hermes/logs/`	モデル呼び出しとツール痕跡が見える
ロールバック	`~/hermes-lab/output/*` を削除	再実行で一貫した結果

検証前に一度だけ骨格を作成します：

                    mkdir -p ~/hermes-lab/{input,output}

                    # ~/hermes-lab/input/notes.md にテスト用段落を数行書く

2ケースのためのインストール環境を準備する

→ハードウェア：Apple Silicon または Intel Mac。RAM 16GB 以上・空きディスク 5GB 以上推奨。uname -m と sw_vers でチップと OS を確認。
→依存関係：事前に必要なのは git --version のみ。Python 3.11、Node v22、ripgrep、ffmpeg は公式インストーラが処理します。
→ネットワーク：GitHub raw と利用 LLM API（OpenRouter、Anthropic 等）に到達できること。
→アカウント：少なくとも 1 つの provider API キー。シークレットは ~/.hermes/.env にのみ保存し chmod 600 を実行。
→権限：ローカル管理者アカウント。ファイル・ターミナルツール初回利用時の macOS プライバシーダイアログを承認。

⚠️境界：本番 Git リポジトリ、実プライベートファイル、ブラウザ保存パスワード、クラウド管理者資格情報には触れない。このケースでは --yolo や approvals.mode: off を有効にしない。

3Hermes Agent をインストールしバージョンを確認する

                    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
                

続けて source ~/.zshrc を実行し、公式フローに従い hermes setup または hermes model を実行します。インストール後に確認：

✓which hermes → 通常 ~/.local/bin/hermes
✓hermes doctor にブロッカーなし（キー未設定ならモデル設定を促す）
✓hermes update でバージョン表示。コードは ~/.hermes/hermes-agent/、データは ~/.hermes/

hermes doctor が通るまで、ケース設定に進まないでください。

4ケース用にモデルと API キーを設定する

hermes model で provider とデフォルトモデルを選択（名称・課金は変わるため provider サイトを確認）。~/.hermes/.env に直接書く例：

                    # 例—provider に合わせて調整

                    OPENROUTER_API_KEY=sk-or-...

                    chmod 600 ~/.hermes/.env

接続確認：~/hermes-lab から hermes を起動し「reply OK」と送信。API エラーならケース続行前に hermes config check を実行。

5ディレクトリ境界と権限を設定する

初回検証ではテストディレクトリ内で作業：hermes 起動前に cd ~/hermes-lab。後で Messaging Gateway を使う場合は ~/.hermes/.env に MESSAGING_CWD=~/hermes-lab を設定し、機密パスから起動しない（公式セキュリティガイド参照）。

→approvals.mode: manual（デフォルト）を維持—危険コマンドは人間が承認。
→高度な分離：~/.hermes/config.yaml で terminal.backend: docker（本番 Gateway 推奨）。
→Git 追跡される可能性のある ~/hermes-lab 内ファイルに API キーを置かない。

6本番ケース前の事前ゲート

①モデル ping：会話が正常に返る
②ファイル読取：input/notes.md 第 1 段落の要約を Agent に依頼
③ファイル書込：output/ping.txt に ok を書く
④ログ確認：ls ~/.hermes/logs/—CLI セッション記録が追跡可能

いずれかのゲートが失敗したら、その層でトラブルシュートしてから本番ケースへ。

7完全な実戦ケースを実行する

~/hermes-lab から hermes を起動し、明確なタスクプロンプトを使用（コピーして調整可）：

このディレクトリ内のみ作業。 input/notes.md を読み、200 語以内の要約を output/summary.md に書き、実行可能な ToDo を最大 5 件 output/todos.md に Markdown リストで書く。このディレクトリ外のパスにアクセスしたり、破壊的シェルコマンドを実行しない。

実行中に削除やシステム設定コマンドが出たら、CLI 承認プロンプトで拒否—安全設定が有効である証拠です。

8検証・排障・ロールバック確認

確認項目	コマンド / 場所
出力ファイル	`cat ~/hermes-lab/output/summary.md`、`todos.md`
権限漏れ	`~/` やデスクトップに想定外の新規ファイルがないか確認
ログ	`~/.hermes/logs/`（Gateway は `gateway.log` が多い）
コスト	provider ダッシュボードで今回実行のトークン使用量
ロールバック	`rm -rf ~/hermes-lab/output/*` 後に再実行

層別の失敗診断：

→hermes: command not found → インストール層：PATH、source ~/.zshrc
→401 / モデル無応答 → モデル層：hermes model、.env 権限
→ファイル読み書き不可 → 権限層：作業ディレクトリ、MESSAGING_CWD、macOS プライバシー許可
→hermes doctor 設定エラー → 設定層：hermes config migrate
→ツールループ・話題逸脱 → タスク層：プロンプト短縮、出力パス固定

9テストケースから本番 workflow へ拡張する

ケース通過後、検証を飛ばさず段階的に権限と自動化を広げます：

1実ソースフォルダは読み取り専用。出力は別の draft/ ディレクトリへ
2hermes gateway setup + gateway install で launchd 常駐（plist：~/Library/LaunchAgents/ai.hermes.gateway.plist）
3より高い自動化には Docker backend、コマンド許可リスト、プラットフォームユーザ許可リストを検討

インストール前の詳細チェックリストはHermes Agent Mac セットアップチェックリストを参照。

10Mac mini ならケース実行がよりシンプル

本ガイドのインストール・設定・ログ確認は macOS ネイティブで動作—WSL 不要で Terminal、Homebrew、Docker、launchd がそのまま使えます。Mac mini M4 はアイドル時約 4W。Apple Silicon の統一メモリは、Hermes CLI と Gateway の長時間稼働に静かなノードとして最適です。Gatekeeper と FileVault も、Agent 常時オンライン時の露出を抑えます。

このテストケースを 7×24 workflow に昇格させるなら、Mac mini M4 はコスト効率の良いハードウェア起点です。今すぐ入手し、常時稼働向けマシンでインストールと設定を完遂しましょう。

ケース駆動クイックリファレンス

①ケースディレクトリと出力基準を定義
②公式インストール + hermes doctor
③モデルキー + テストディレクトリ境界
④段階ゲート → 本番ケース → ログとロールバック
⑤その後 Gateway と本番 workflow へ

nuzcloud · Mac Cloud

Mac mini で Hermes Agent 実戦ケースを実行

専用 Mac mini M4 ベアメタル、即時プロビジョニング · 常時オン Gateway、ローカル Agent、リモート開発向け。本チュートリアルの各ステップに安定したハードウェア基盤を。

今すぐ購入 →

2026 Hermes Agent 完全インストール＆設定ガイド：実戦ケースで通し切る丁寧チュートリアル