OmniProxy.ai
日本語
EnglishEnglish (Australia)English (Canada)English (United Kingdom)English (United States)简体中文繁體中文（台灣）繁體中文（香港）DeutschDeutsch (Deutschland)EspañolEspañol (Latinoamérica)Español (México)Español (España)Bahasa Indonesia한국어ItalianoFrançaisFrançais (Canada)Français (France)日本語Bahasa MelayuMaltiPolskiPortuguês (Brasil)Português (Portugal)РусскийไทยTürkçeУкраїнськаTiếng Việtአማርኛবাংলাবাংলা (বাংলাদেশ)БългарскиCatalàHrvatskiČeštinaDanskNederlandsNederlands (Nederland)EestiFilipinoSuomiΕλληνικάગુજરાતીગુજરાતી (ભારત)हिन्दीMagyarಕನ್ನಡಕನ್ನಡ (ಭಾರತ)LatviešuLietuviųമലയാളംമലയാളം (ഇന്ത്യ)मराठीमराठी (भारत)Norskଓଡ଼ିଆਪੰਜਾਬੀRomânăСрпскиSlovenčinaSlovenščinaSlovenščina (Slovenija)KiswahiliSvenskaதமிழ்தமிழ் (இந்தியா)తెలుగుతెలుగు (భారతదేశం)
العربيةالعربية (السعودية)עבריתفارسیاردواردو (پاکستان)
エージェント

Hermes のインストールと OmniProxy の設定

以前に行ったことをアシスタントに覚えさせたいものの、毎回最初から説明したくない場合、Hermes なら会話やタスクの経験を保持し、普段使っているチャットツールから作業を続けられます。

ドキュメントレビュー済み
2026/10/09
公式ドキュメントレビュー済み
Hermes Agent v0.21.6

Hermes は、会話やタスクの経験を保持できるアシスタントです。実行したことを整理し、後で再利用できるスキルにすることもできます。また、同じ Gateway を通じて Telegram、Discord、Slack、WhatsApp、Signal、ターミナルに接続できます。Gateway は、メッセージを一元的に受信して転送する入口と考えることができます。普段使っているチャットツールからコードレビュー、インシデント記録、顧客向け資料などを渡し、その後リポジトリに戻って処理を続けさせることができます。

インストール前の準備

まず、使用しているコンピューターのOSに応じてインストール方法を選びます。macOS と Windows ではウィンドウ付きのインストーラーを直接使用できます。Linux、macOS、WSL2 ではターミナルスクリプトを使用できます。WSL2 は、Windows 上で Linux 環境を実行するための機能です。Android スマートフォンの Termux と Docker にもそれぞれインストール方法がありますが、このガイドでは一般的なコンピューターへのインストールのみを説明します。

ウィンドウが必要

macOS、Windows

  • macOS：DMG を開く
  • Windows：インストーラーを開く
  • アプリをシステムに配置

ターミナルだけでよい

Linux、macOS、WSL2

  • 1 行の install.sh
  • Windows では install.ps1 を使用
  • インストール後に hermes と入力

今は使用しない

pip、brew、AUR

  • これらのインストール方法は公式サポート対象外
  • インストール後の更新も難しい
  • 左側の 2 つの方法を使用
このガイドで使用するのは、ウィンドウ付きインストーラーとターミナルスクリプトの2通りです。pip、brew、AUR は正式にサポートされているインストール方法ではありません。

始める前に、macOS、Windows、Linux のいずれかを搭載したコンピューターを用意し、ターミナルを開けることと、GitHub にアクセスできることを確認してください。外付けドライブにインストールする場合は、あらかじめドライブを接続し、十分な空き容量があることも確認します。

インストールと初回起動

ウィンドウを使用する場合

Hermes 公式サイトのダウンロードセクションにアクセスし、使用しているシステムに対応したインストーラーをダウンロードします。インストーラーには実行環境が含まれているため、初回起動時にコンピューター上でコンパイルする必要はありません。

  • macOS：DMG を開き、Hermes.app を「アプリケーション」に移動します。DMG は macOS で一般的に使われるインストール用ディスクイメージファイルです。このインストーラーは Apple シリコンのみに対応しており、Intel Mac はサポート対象外です。
  • Windows：Windows のアプリ インストーラーで .appinstaller を開きます。署名済みの MSIX、つまり Windows で使用されるアプリパッケージがインストールされます。
  • Linux：デスクトップ用インストーラーは macOS と Windows 向けです。Linux では以下のターミナルコマンドを使用し、インストール後に hermes desktop を実行できます。

ターミナルのみを使用する場合

Linux、macOS、WSL2 を使用している場合は、ターミナルで次を実行します。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows 標準の PowerShell を使用する場合は、次を実行します。

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

インストーラーが Hermes のコードと実行に必要なプログラムをダウンロードします。途中でダウンロードが中断された場合は、同じコマンドをもう一度実行してください。インストールが完了したら、現在のターミナルを閉じ、新しいウィンドウを開いて次を入力します。

hermes

Hermes のプロンプトが表示されれば、コマンドを使用できます。続いて hermes doctor を実行できます。これはインストール状態を確認し、現在不足しているものを通知するチェック機能です。

プログラムを外付けドライブに置く場合

2026年10月9日、Hermes Agent v0.21.6 を1台の Mac の外付けドライブにインストールしました。プログラムは /Volumes/AItools/tools/hermes-agent、起動コマンドは ~/.local/bin/hermes にあり、設定と会話は引き続き ~/.hermes に保存されます。

ドライブ名が異なる場合は、--dir の後ろのパスを自分のフォルダーに変更してください。Hermes の実行中は、このドライブを接続したままにする必要があります。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

プログラム

外付けドライブ

  • tools/hermes-agent
  • コードはここに配置

コマンド

~/.local/bin/hermes

  • ターミナルで hermes と入力
  • 新しいウィンドウを開くと反映される

設定と会話

~/.hermes

  • config.yaml はここにある
  • ドライブを取り外す前に終了する
これは、テストした Mac での配置です。デフォルトのインストールではプログラムがユーザーディレクトリに配置されますが、操作は同じです。新しいターミナルを開き、hermes と入力します。

OmniProxy から接続情報を取得する

ここでは、Hermes を Grok や Gemini に直接接続するのではなく、OmniProxy に接続します。Grok と Gemini のサービスアドレスは OmniProxy 側で設定し、Hermes に直接入力しないでください。

あなたのコンピューター

Hermes

ローカルゲートウェイ

OmniProxy

  • アドレスには /v1 まで含める

Grok

  • grok-4.7

Gemini

  • gemini-3.8-flash
Hermes から見える接続先は OmniProxy です。Grok と Gemini への転送は OmniProxy が行います。

モデル ID は、API がモデルを識別するために使用する正確な名前です。2つのモデルには、それぞれ次の名前を使用します。

  • Grok には grok-4.7 を入力します。xAI の API は https://api.x.ai/v1 で、チャットリクエストには /v1/chat/completions を使用します。Grok モデルドキュメントを参照してください。
  • Gemini には gemini-3.8-flash を入力します。Google の OpenAI 互換 API は https://generativelanguage.googleapis.com/v1beta/openai/ です。Gemini の OpenAI 互換性に関する説明を参照してください。

Hermes で Gemini に切り替える場合は、モデル名を gemini-3.8-flash に変更するだけです。API アドレスには引き続き OmniProxy のアドレスを入力します。

OmniProxy から API アドレスとキーをコピーし、対応するモデル ID とともに入力します。

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL は Hermes がリクエストを送信する API アドレスで、ここでは /v1 で終わる必要があります。API Key は OmniProxy が Hermes に発行するキーです。自分のキーに置き換え、公開ページには掲載しないでください。

ローカルの OmniProxy でキーが要求されていない場合、API Key は空欄にできます。ただし、そのアドレスにほかの人からアクセスできる場合は、キーを設定してください。また、Hermes が動作する環境からそのアドレスにアクセスできることも確認します。Hermes と OmniProxy が同じコンピューター上にある場合は、ローカルアドレスを使用できます。

ツールの設定を入力する

まず進行中のチャットを終了し、ターミナルで次を実行します。

hermes model

Custom endpoint (self-hosted / VLLM / etc.) を選択します。Custom endpoint はカスタム API を意味し、あらかじめ用意された接続先ではなく、自分で指定したサービスアドレスに Hermes を接続します。

ウィザードでは API アドレス、キー、モデル名の順に確認されるので、前のセクションで説明した3項目を入力します。Gemini を使用する場合は、モデル名に gemini-3.8-flash を入力します。

~/.hermes/config.yaml を直接編集することもできます。YAML は、インデントを使って設定の関係を表すテキスト形式です。Grok の設定は次のとおりです。

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Gemini を使用する場合は、default を gemini-3.8-flash に変更し、残りの3項目は変更しません。

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

保存後、hermes をもう一度実行してからチャットを開始します。すでに開いているセッションでは、/model は保存済みの接続先を切り替えるためだけに使用でき、この設定を新規追加することはできません。

実際のタスクで確認する

1

hermes doctor

  • インストールチェックに合格

2

短いメッセージを送る

  • Hermes からの応答を確認

3

呼び出し履歴を開く

  • モデル名を確認
3つの手順をすべて完了して、初めてこの設定が使用可能だと確認できます。
  1. hermes doctor を実行し、インストールが完全かどうか確認します。
  2. hermes を実行し、何ができるかを1文で説明するよう依頼します。回答が表示されるはずです。
  3. OmniProxy の呼び出し履歴を開き、今回のリクエストが Hermes から送信されたことを確認し、モデル名が grok-4.7 または gemini-3.8-flash になっているか確認します。

ウィザードで保存成功と表示された、または API が成功を返しただけでは、Hermes がタスクを実行できるとは判断できません。呼び出し履歴のモデル名が、入力した内容と一致している必要があります。

ブラウザーでチャットする場合は、ローカル環境で次を実行します。

hermes dashboard --no-open --host 127.0.0.1 --port 9119

その後、http://127.0.0.1:9119 を開きます。このアドレスは現在使用しているコンピューター上でのみ有効です。

よくあるエラー

  • hermes を入力するとコマンドが見つからないと表示される：まずターミナルを閉じ、新しいウィンドウを開きます。それでも見つからない場合は、~/.local/bin が PATH に含まれていることを確認してください。PATH は、システムがコマンドのあるディレクトリを検索するための場所の一覧です。Windows では、インストーラーが追加した起動ディレクトリが PATH に含まれていることを確認します。
  • インストール中にダウンロードが中断された：同じインストールコマンドをもう一度実行してください。ダウンロード済みの部分は引き続き使用されます。
  • Hermes が応答しない、または接続できないと表示される：OmniProxy が動作していることを確認し、Base URL が /v1 で終わっているか確認します。Hermes が Docker 内で動作し、OmniProxy がホストマシン上にある場合は、コンテナ内部でのみ有効な 127.0.0.1 を使用しないでください。
  • キーが正しくないと表示される：OmniProxy のキーを更新し、config.yaml の api_key も変更します。xAI または Google のキーは OmniProxy のプロバイダー設定に属するため、Hermes のこの欄には入力しないでください。
  • モデルが存在しないと表示される：OmniProxy の現在のモデル一覧を開き、grok-4.7 または gemini-3.8-flash を一覧に表示されている表記のままコピーします。
  • 応答はあるものの、ファイルの読み取りやコマンドの実行などができない：OmniProxy 内の、これらの機能に対応した別のモデルに変更し、Hermes を新たに起動します。
  • プログラムを外付けドライブに置いており、ドライブを取り外した後に hermes doctor でストレージエラーが発生する：まず、そのドライブを再接続してください。ドライブが接続されていない状態で、Hermes に別の設定一式を作成させないでください。

公式リファレンス

インストール手順については、Hermes インストールドキュメントとプラットフォームサポートを参照してください。Custom endpoint の設定については、Hermes Provider ドキュメントを参照してください。モデル ID については、それぞれ Grok モデルドキュメントとGemini の OpenAI 互換性に関する説明を参照してください。

macOS でのインストールは、2026-10-09 に Hermes Agent v0.21.6 を使用して一通り検証しました。grok-4.7 と gemini-3.8-flash は、同日時点の xAI および Google のドキュメントに記載されていた標準モデル ID です。実際に入力するときは、OmniProxy に表示されている名前に従ってください。

プレースホルダーをすべて独自の設定値に置き換えてください。実際のキーを公開しないでください。

保存された結果や HTTP 200 だけでは完全なエージェント互換性が証明されません。OmniProxy の呼び出し記録でソースとモデルを確認してください。

公式ソース · Hermes ↗