トップ›インストール

📦 インストール

必要環境の確認からHermesの起動確認まで、手順を順番に進めます。

🖥️ 必要環境

項目要件備考
OSmacOS / Linux / Windows (WSL2)macOS推奨（Apple NotesなどmacOS限定スキルあり）
RAM8GB 以上ローカルLLMを使う場合は16GB〜64GB推奨
ストレージ5GB 以上の空きモデルファイル別途
Python3.10 以上インストーラーが自動セットアップ
Node.js18 以上（推奨）一部スキルで必要。インストーラーが対応
インターネット初回インストール時のみ必要モデルAPIを使う場合は常時接続

⚡ インストール

macOS / Linux / WSL2

ターミナルを開いて以下を実行します。インストーラーがPython・Node.js・ripgrep・ffmpegなど必要なものをすべてセットアップします。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
ℹ️
インストール先は ~/.hermes/ です。システム全体への変更は最小限で、アンインストールもこのフォルダを削除するだけです。

Windows（ネイティブ PowerShell）

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

WSL2を使う場合は上のLinuxコマンドが使えます。

🔄 シェルの再読み込み

インストール後、PATHを反映させるためにシェルを再起動します。

source ~/.zshrc   # zshの場合（macOSデフォルト）
source ~/.bashrc  # bashの場合

✅ 動作確認

  1. バージョン確認
    hermes --version
    バージョン番号が表示されればインストール成功。
  2. 初回起動
    hermes
    対話型TUIが起動します。初回はモデルの選択を求められます。
  3. セットアップウィザード（任意）
    hermes setup
    モデル・APIキー・Telegram接続などをガイドに沿って一括設定できます。
💡
Nous Portal を使うと最速
APIキーをまとめて管理したい場合は hermes setup --portal で Nous Portal にログインするだけで、モデル・Web検索・画像生成・TTS が一括で使えるようになります。

🩺 トラブルシューティング

症状対処
hermes: command not foundsource ~/.zshrc を実行してPATHを再読み込み
インストールが途中で止まるインターネット接続を確認。VPN使用中の場合は一時的に無効化
Python バージョンエラーpython3 --version で確認。3.10未満の場合はPythonを先にアップデート
その他エラーhermes doctor で診断レポートを表示
次：初期設定 →