Hermes Agentのインストール方法：初心者向け設定ガイド

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

Hermes Agentはターミナルでの利用を前提としたソフトウェアのため、コマンドラインからインストールします。お使いのコンピューターに該当する項目を選んでください。

• macOS：Applications > Utilities > TerminalからTerminalを開くか、Command + Spaceを押して「Terminal」を検索します。

• Windows：まずWSL2をインストールし、Linuxディストリビューションのターミナルを開いてから、Linux用のコマンドに従ってください。

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

想定される出力：

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

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

ターミナルで、公式インストーラーのコマンドをコピーして貼り付けます。

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

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

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

想定される結果：

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

想定される結果：

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

Hermes Agentが回答したりツールを使用したりするには、モデルプロバイダーが必要です。初めて設定する場合は、対話形式が最も簡単です。

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

デフォルトモデルを選択します。Kimi K3はKimiの最新フラッグシップモデルです。主にコーディングを行う場合は、kimi-k2.7-codeのほうが適しています。

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

Hermes AgentでKimi APIを使用する前に、Kimi プラットフォームでKimi API Keyを有効にしてください。複雑な複数ステップのタスクでレイテンシーを抑え、より安定したパフォーマンスを得るには、Tier 2アクセスが有効になる$20以上をおすすめします。

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

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

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

または、新しいターミナルUIを試します。

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

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

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

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

OpenClawと同様に、Hermes Agentはボットとして機能し、チャットアプリに接続できます。

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

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

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

対処法：

または：

次に、以下を試してください。

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

Ubuntu、Debian、またはWSL2での対処法：

Homebrewを使用したmacOSでの対処法：

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

対処法：

または、キーを手動で設定します。

原因：アップデート後、設定ファイルが不完全になっている可能性があります。

対処法：

原因：ベースURL、モデル名、またはコンテキスト長が正しくありません。

対処法：まず別のクライアントでエンドポイントをテストし、OpenAI互換であることを確認してください。また、通常のHermes Agentワークフローでは、モデルが少なくとも64Kのコンテキストをサポートしていることを確認してください。

Hermes Agentを最も簡単にインストールするには、公式のワンラインインストーラーを使用し、シェルを再読み込みしてhermes modelを実行し、実際のチャットを1回行ったうえでhermes doctorにより設定を確認します。最初のセットアップは、1台のマシン、1つのプロバイダー、1つの正常に動作する会話というシンプルな構成にしてください。基本となるHermes Agentアシスタントが安定してから、Dockerによる分離、ゲートウェイボット、スキル、スケジュール済み自動化、カスタムモデルプロバイダーを安全に追加できます。