Hermes Agent - 自己改善型AIエージェント

このガイドでは、Hermes Agentをインストールし、Lychee AIをカスタムモデルプロバイダーとして設定する方法を説明します。

事前準備

次の情報を用意してください。

1. API URL：https://lizh.ai/v1
2. API Key：Lychee AIにログインし、「コンソール → API Key管理」で作成してコピー
3. モデルID：Lychee AIのモデル広場から、使用するモデルの正確な名称をコピー

Hermes Agentをインストールする

macOS、Linux、WSL2

ターミナルでHermes公式のインストールコマンドを実行します。

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

Windows

PowerShellで次のコマンドを実行します。

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

インストール後、新しいターミナルを開いてバージョンを確認します。

hermes version

バージョン情報が表示されれば、Hermesのインストールは完了です。

Lychee AIを設定する

Hermesでは、モデル設定ウィザードを使ってOpenAI互換のカスタムエンドポイントを追加する方法が推奨されています。

1. モデル設定ウィザードを開く

ターミナルで次のコマンドを実行します。

hermes model

2. カスタムエンドポイントを選択する

Provider一覧から次の項目を選択します。

Custom endpoint (self-hosted / VLLM / etc.)

バージョンによって表示が多少異なる場合があります。Custom endpointを含む項目を選択してください。

3. 接続情報を入力する

ウィザードの案内に従い、次の内容を入力します。

Context lengthの入力を求められた場合は、モデルに表示されているコンテキスト長を入力してください。不明な場合は、まずHermesが提示するデフォルト値を使用できます。

設定が完了すると、Hermesはモデル、Provider、API URLを~/.hermes/config.yamlに保存します。ターミナルを再起動しても設定は維持されます。

接続を確認する

次のコマンドを実行します。

hermes chat

チャットが始まったら、簡単なメッセージを送信します。Hermesから回答が返れば、API URL、API Key、モデルIDは正しく設定されています。

後からLychee AIのモデルを変更する場合は、現在のセッションを終了して次を実行します。

hermes model

手動設定（任意）

対話型ウィザードを使用できない場合は、~/.hermes/config.yamlを編集します。

model:
  default: "モデル広場からコピーしたモデルID"
  provider: custom
  base_url: https://lizh.ai/v1
  api_key: "あなたのlizh.ai API Key"

保存後、hermes chatを再度実行します。YAMLのインデントにはTabではなくスペースを使用してください。実際のAPI Keyを含む設定ファイルを公開リポジトリへ登録しないでください。

よくある問題

401またはAuthentication failedと表示される

API Keyが無効、期限切れ、または正しくコピーされていない可能性があります。Lychee AIのAPI Key管理で状態を確認し、必要に応じて新しいKeyを作成してください。

404、Model not found、またはモデルを利用できない

モデルIDは、Lychee AIのモデル広場に表示されている名称と完全に一致する必要があります。大文字と小文字、ハイフン、バージョン番号を確認してください。

APIに接続できない

API Base URLがhttps://lizh.ai/v1であり、末尾に/v1が含まれていることを確認します。また、現在のネットワークからLychee AIへアクセスできるか確認してください。

/modelにLychee AIが表示されない

Hermesのチャットセッションを終了し、システムのターミナルでhermes modelを実行して、先にカスタムエンドポイントを設定してください。設定後は、セッション内の/modelでモデルを切り替えられます。

hermes: command not foundと表示される

ターミナルを閉じて再度開いてください。それでも実行できない場合は、Hermes公式FAQに従ってインストール先とPATHの設定を確認してください：FAQ & Troubleshooting。