Hermes Agent のインストール方法：初心者向けセットアップガイド

Q: Hermes Agent をインストールした後は何をすればよいですか?

`hermes model` を実行して Kimi などのプロバイダーを1つ選び、`hermes` を起動して通常のチャットを1回試し、`hermes doctor` を実行し、`hermes --continue` でセッションが再開できることを確認します。その後、必要に応じて Docker による分離、スキル、MCP サーバー、音声、cron、メッセージングゲートウェイを追加してください。

macOS と Windows に Hermes Agent をインストールする方法を解説します。初心者向けのコマンド、モデルのセットアップ手順、動作確認、トラブルシューティングを順に紹介します。

Kimi API でセットアップする

10分読む2026-07-13

Hermes Agent は Nous Research が提供するオープンソースの AI エージェントで、ターミナルから実行し、さまざまなモデルプロバイダーに接続し、セッションをまたいで有用なコンテキストを記憶し、ツール、スキル、メッセージングゲートウェイ、自動化によって拡張できます。このガイドでは Hermes のインストール方法を説明します。macOS または Windows 用の標準インストーラーでは、公式インストーラーが主要な依存関係を処理してくれるため、Python や Node.js を手動でインストールする必要はありません。

Hermes Agent をインストールする前に

Hermes Agent はターミナル操作が前提のソフトウェアなので、コマンドラインからインストールします。お使いのコンピューターに合ったセクションを選んでください。

macOS: アプリケーション > ユーティリティ > ターミナルからターミナルを開くか、Command + Space を押して「ターミナル」を検索してください。
Windows: まず WSL2 をインストールし、Linux ディストリビューションのターミナルを開いて、Linux 用のコマンドに従ってください。

Git も必要です。Git がインストールされているか確認します。

git --version

期待される出力:

git version 2.x.x

git: command not found と表示された場合は、まず Git をインストールしてください。

# Ubuntu / Debian / WSL2 sudo apt update sudo apt install -y git

# macOS with Homebrew brew install git

macOS で Homebrew を使用していない場合は、次のコマンドを実行して Apple Command Line Tools から Git をインストールしてください。

xcode-select --install

手順1: macOS または Windows に Hermes Agent をインストールする

ターミナルに、公式インストーラーのコマンドをコピー&ペーストします。

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

公式インストーラーコマンドで Hermes Agent アシスタントをインストールする

インストーラーは Hermes Agent をダウンロードし、Python 実行環境を準備し、必要な依存関係をインストールし、hermes コマンドをシェルのパスに追加します。通常のユーザーインストールでは、Hermes のデータは ~/.hermes/ に保存されます。

コマンドが完了したら、シェルを再読み込みします。

source ~/.bashrc

macOS で一般的な Zsh を使用している場合は、次を実行してください。

source ~/.zshrc

期待される結果:

# No error output

次に、Hermes Agent コマンドが利用可能であることを確認します。

hermes --version

期待される結果:

hermes, version ...

Hermes Agent の更新に伴い、正確なバージョン番号は変わる場合があります。

手順2: モデルプロバイダーを設定する

Hermes Agent が応答したりツールを使用したりするには、まずモデルプロバイダーを設定する必要があります。初心者にとって最も簡単な方法は、対話形式のセットアップです。

hermes model

ウィザードでは Kimi/Moonshot などのプロバイダーを選択できます。まず基本的なチャットが動作することを確認するまで、ルーティング、フォールバック、ゲートウェイ、cron の設定は行わないでください。

デフォルトのモデルを選択します。kimi-k2.6 は Kimi の現時点で最も高性能なモデルです。

設定したい値がすでに分かっている場合は、hermes config set を使用できます。例：

hermes config set Moonshot_API_KEY sk-or-your-key-here

API キーをお持ちでない場合は、Kimi を選ぶのも良い選択です。

ステップ1：Kimi API を有効化する

Hermes Agent で Kimi API を使用する前に、Kimi オープンプラットフォームで Kimi API Key を有効化してください。20 ドル以上をチャージして Tier 2 アクセスを解放することをおすすめします。これによりレイテンシが低減され、複雑な複数ステップのタスクでもより安定した性能を発揮できます。

Kimi API でセットアップする

ステップ2：Kimi API Key を作成する

Kimi オープンプラットフォームの API Keys セクションに移動し、「Create API Key」をクリックします。API キーは作成時に一度しか表示されないため、必ずコピーして安全に保管してください。

ステップ3：API キーを入力する

Kimi API キーを貼り付けて、Hermes Agent を接続します。

ステップ3：Hermes Agent を起動する

モデルの設定が完了したら、従来型の CLI を起動します。

hermes

または、新しいターミナル UI を試すこともできます。

hermes --tui

選択したプロバイダー／モデルが表示されたウェルカム画面またはプロンプトが表示されるはずです。簡単なリクエストでテストしてみましょう。

現在のディレクトリを確認して、どんなファイルがあるか教えてください。

成功すると次のように表示されます。

Hermes が認証エラーなしで応答すること。 Hermes が現在のディレクトリを読み取り、内容について推論できること。最初の応答の後もセッションが継続すること。

Hermes Agent は起動するものの、モデルや認証のエラーが返される場合は、次を実行してください。

hermes model

その後、プロバイダーを再度選択し、API キーまたは OAuth ログインを確認してください。

ステップ4：Hermes Agent をボットにする

OpenClaw と同様に、Hermes Agent もボットとして動作させ、チャットアプリに接続できます。

hermes gateway setup

設定後、ゲートウェイのステータスを確認します。

hermes gateway status

ゲートウェイは、ターミナル上でモデルプロバイダーが正常に動作することを確認してから使用してください。CLI で基本的なチャットが完了できない場合、ボットも同じ原因で失敗することが多いです。

Hermes Agent インストール時のよくある問題

`hermes: command not found`

原因：ターミナルが PATH の変更をまだ再読み込みしていません。

対処法:

source ~/.bashrc

または:

source ~/.zshrc

次に試す:

hermes --version

`git: command not found`

原因: Git がインストールされていません。

Ubuntu、Debian、WSL2 での対処法:

sudo apt update sudo apt install -y git

Homebrew を使った macOS での対処法:

brew install git

APIキーが設定されていない

原因: Hermes Agent はインストールされていますが、プロバイダーキーまたはログインが設定されていません。

対処法:

hermes model

またはキーを手動で設定:

hermes config set OPENROUTER_API_KEY sk-or-your-key-here

`hermes doctor` が設定の欠落または古い設定を報告する

原因: 更新後、設定ファイルが不完全になっている可能性があります。

対処法:

hermes config check hermes config migrate hermes doctor

カスタムエンドポイントには接続できるが、不正な応答が返る

原因: ベースURL、モデル名、またはコンテキスト長が間違っています。

対処法: まず別のクライアントでエンドポイントをテストし、OpenAI互換であることを確認したうえで、通常のHermes Agentのワークフローに必要な最低64Kのコンテキストにモデルが対応していることを確認してください。

コマンドクイックリファレンス

まとめ

Hermes Agentを最も簡単にインストールする方法は、公式のワンライナーインストーラーを使い、シェルを再読み込みしてからhermes modelを実行し、実際のチャット1回とhermes doctorでセットアップを確認することです。最初のセットアップはシンプルに保ちましょう。1台のマシン、1つのプロバイダー、1つの動作する会話です。基本のHermes Agentアシスタントが安定したら、Dockerによる分離、ゲートウェイボット、スキル、スケジュール自動化、カスタムモデルプロバイダーなどを安心して積み重ねていけます。

よくある質問

Hermes Agent とは何ですか?

Hermes Agent は Nous Research が提供するオープンソースの AI エージェントプラットフォームです。ターミナルから実行し、多数のモデルプロバイダーに対応し、ツールを利用でき、設定は ~/.hermes/ に保存され、スキル、メモリ、スケジュールジョブ、メッセージングゲートウェイで拡張できます。

Hermes Agent はソフトウェアですか、それとも Web アプリですか?

Hermes Agent はローカル環境、WSL2、サーバー、または Termux などの対応環境にインストールするソフトウェアです。単なるホスト型の Web アプリではありません。多くのユーザーはこれをターミナルベースの AI アシスタントとして、あるいは VPS 上で常時稼働するエージェントとして利用しています。

Hermes Agent をインストールする前に Python や Node.js は必要ですか?

公式インストーラーを使う場合、通常は Python や Node.js を手動でインストールする必要はありません。インストーラーが主要な依存関係を処理します。まず Git が利用可能であることを確認してください。

Windows で Hermes Agent を使えますか?

はい。初心者にはまず WSL2 を使う方法をお勧めします。Windows ネイティブ対応も存在しますが、公式ドキュメントでは初期ベータ扱いとされているため、Linux/macOS/WSL2 の場合よりも荒削りな部分が多いと考えておいてください。

Hermes Agent をインストールした後は何をすればよいですか?

hermes model を実行して Kimi などのプロバイダーを1つ選び、hermes を起動して通常のチャットを1回試し、hermes doctor を実行し、hermes --continue でセッションが再開できることを確認します。その後、必要に応じて Docker による分離、スキル、MCP サーバー、音声、cron、メッセージングゲートウェイを追加してください。