Hermes を動かす
Hermes Agent v0.8.0 は Linux、macOS、WSL2 で約 60 秒で入る。curl 1 発で、インストーラが uv、Python 3.11、Node.js、ripgrep、ffmpeg まで面倒を見てくれる。
checklist システム要件
事前に必要なのは git だけ。Python 3.11、Node.js v22、uv、ripgrep、ffmpeg はスクリプトがインストールする
Linux、macOS、Windows 上の WSL2、または Termux 経由の Android。ネイティブ Windows は非対応。
最低 2 GB の RAM。ローカルモデルを動かすならもっと必要
agent、venv、Node modules、内蔵スキルで約 1 GB
オプション：コマンド実行を sandbox 化する Docker、SSH、Daytona、Singularity、Modal
ホスト型モデル API にはネット接続が必要。OpenAI 互換 endpoint のローカルモデルはオフラインでも動く。
公式ドキュメントの 1 行コマンド。Linux、macOS、WSL2 ユーザーにはこれを推奨する。 インストールドキュメント arrow_forward
WSL2（Windows）
ネイティブ Windows は非対応。'wsl --install' したあと、WSL2 シェルの中でこのコマンドを実行する。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash macOS / Linux / WSL2
事前に必要なのは git だけ。uv、Python 3.11、Node.js v22、ripgrep、ffmpeg はインストーラが面倒を見る。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash verified インストールを確認
公式ドキュメントの検証コマンドを実行する。
hermes version インストール済みのバージョンを表示する（0.8.0 以降のはず）。
hermes doctor 診断を実行。Python、uv、依存関係、設定ファイル、接続性をチェックする。
hermes status 現在の設定を表示：モデルプロバイダ、有効なツール、接続中の gateway。
settings 初期設定
インストール後、シェルを読み直し、ドキュメント掲載の 3 つのセットアップコマンドを実行する。
モデルプロバイダを選ぶ
'hermes model' を実行してプロバイダを選ぶ。README には Nous Portal、OpenRouter、z.ai/GLM、Kimi/Moonshot、MiniMax、OpenAI、カスタム endpoint が並ぶ。Anthropic と Mistral も依存として同梱される。
使いたいツールを有効にする
'hermes tools' を実行し、47 個の内蔵ツールのうちどれを有効にするか設定する。あとから足したり外したりできる。
フルセットアップウィザードを実行
'hermes setup' を実行し、API key とチャット gateway 接続（Telegram、Discord、Slack、WhatsApp、Signal、Email）まで含む完全な流れを通す。
テストメッセージを送る
'hermes chat -q "Hello! What tools do you have available?"' を試す。公式 quickstart にそのまま載っている。
.env — 設定は ~/.hermes/ 下にある。メイン設定は config.yaml、API key は .env、加えて session、logs、memories、skills、cron job のサブディレクトリが並ぶ。環境変数のリファレンスは hermes-agent.nousresearch.com/docs/reference/environment-variables を見てほしい。
cloud VPS／サーバーデプロイ
Hermes は 2 GB メモリ・約 1 GB ディスクの Linux VPS で動きます。同じワンライナーを SSH 経由で実行するだけです。
サーバーに SSH でログイン
Ubuntu、Debian、CentOS、Arch など一般的なディストロで動作します。
ssh user@your-server-ip インストーラーを実行
スクリプトがディストロを自動検出し、uv 経由で Python 3.11 をインストールして依存関係をすべてセットアップします。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash サンドボックスバックエンドを有効化
共有インフラ上では、サンドボックスバックエンド（Docker、SSH、Daytona、Singularity、Modal）のいずれかを設定し、Hermes のシェルコマンドを分離環境で実行してください。詳細は README を参照。
API キーを設定して起動
モデルプロバイダーを選んで Hermes を起動します。プロセスはフォアグラウンドで実行されるため、tmux や screen での維持を推奨します。
hermes model && hermes Tip — 常駐デーモンにしたい場合は、tmux/screen 内で Hermes を実行するか、systemd ユニットファイルを作成してください。公式ドキュメントにデーモン設定の例があります。
system_update_alt Hermes をアップグレード
README には内蔵アップデータ 'hermes update' が書いてある。PyPI にも公式 Docker image にも出していないので、他のアップグレードパスは git 経由になる。 アップグレードガイド arrow_forward
hermes update cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]" curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash # 公式 Docker image はまだ出ていない 各バージョンの変更点は github.com/NousResearch/hermes-agent/releases を参照。
delete_forever Hermes をアンインストール
Hermes は ~/.hermes/hermes-agent/ に入り、バイナリは ~/.local/bin/hermes にシンボリックリンクされる。両方を消すにはコマンド 2 本でいい。 アンインストールの注意 arrow_forward
rm ~/.local/bin/hermes rm -rf ~/.hermes/hermes-agent rm -rf ~/.hermes/hermes-agent # 消すべき公式 Docker image はない ユーザーデータも消す（任意）
これで session、記憶、スキル、cron job、API key が消える。必要なものは先にバックアップを。
rm -rf ~/.hermes # WSL シェルの中で実行してほしい。ネイティブ Windows は非対応 助けが必要？
インストールのサポートやコミュニティのトラブルシュートなら、Nous Research Discord に参加するのが早い。