Hermes Agent ☤

Hermes Agent | Hermes Desktop

Nous Research が開発した自己改善型 AI エージェント。 組み込みの学習ループを備えた唯一のエージェントです — 経験からスキルを作成し、使用中に改善し、知識を永続化するよう自ら促し、過去の会話を検索し、セッションをまたいであなたに関する深いモデルを構築します。5ドルの VPS、GPU クラスター、またはアイドル時にほぼコストがかからないサーバーレスインフラで実行できます。ラップトップに縛られることはありません — クラウド VM で作業している間、Telegram から話しかけることができます。

お好みのモデルを自由に使用できます — Nous Portal、OpenRouter、OpenAI、独自のエンドポイント、その他多数。hermes model で切り替え — コード変更なし、ロックインなし。

クイックインストール

Linux、macOS、WSL2、Termux

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

Windows（ネイティブ、PowerShell）

注意: ネイティブ Windows は WSL なしで Hermes を実行します — CLI、ゲートウェイ、TUI、ツールはすべてネイティブに動作します。WSL2 を使用したい場合は、上記の Linux/macOS のワンライナーもそこで動作します。バグを見つけましたか？ 問題を報告してください。

PowerShell でこれを実行します:

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

インストーラーがすべて処理します: uv、Python 3.11、Node.js、ripgrep、ffmpeg、そしてポータブル Git Bash（MinGit、%LOCALAPPDATA%\hermes\git に展開 — 管理者権限不要、システムの Git インストールから完全に分離）。Hermes はこのバンドルされた Git Bash を使用してシェルコマンドを実行します。

Git が既にインストールされている場合、インストーラーはそれを検出して代わりに使用します。それ以外の場合は、約 45MB の MinGit ダウンロードのみが必要です — システムの Git には一切触れたり干渉したりしません。

Android / Termux: テスト済みの手動パスは Termux ガイド に記載されています。Termux では、完全な .[all] エクストラが現在 Android 互換性のない音声依存関係を引き込むため、Hermes は厳選された .[termux] エクストラをインストールします。

Windows: ネイティブ Windows は完全にサポートされています — 上記の PowerShell ワンライナーがすべてをインストールします。WSL2 を使用したい場合は、Linux コマンドもそこで動作します。ネイティブ Windows インストールは %LOCALAPPDATA%\hermes に配置されます。WSL2 インストールは Linux と同様に ~/.hermes に配置されます。

インストール後:

source ~/.bashrc    # シェルを再読み込み（または: source ~/.zshrc）
hermes              # チャットを開始！

トラブルシューティング

Windows Defender またはウイルス対策ソフトが uv.exe をマルウェアとしてフラグ付けする

ウイルス対策ソフト（Bitdefender、Windows Defender など）が Hermes の bin フォルダ（%LOCALAPPDATA%\hermes\bin\uv.exe）から uv.exe を隔離する場合、これは誤検知です。このファイルは Astral の uv — Hermes が Python 環境を管理するためにバンドルしている Rust 製 Python パッケージマネージャーです。ML ベースのウイルス対策エンジンは、パッケージをダウンロードしてインストールする署名なしの Rust バイナリを一般的にフラグ付けします。

コピーが本物であることを確認するには:

# 必要に応じて GitHub CLI をインストール
winget install --id GitHub.cli

# GitHub にログイン
gh auth login

# 検証を実行
$uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
$ver = (& $uv --version).Split(' ')[1]
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zip = "$env:TEMP\uv.zip"
Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing
gh attestation verify $zip --repo astral-sh/uv
Expand-Archive $zip "$env:TEMP\uv_x" -Force
(Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash

証明が「Verification succeeded」と表示され、最後の行が True を出力すれば、問題ありません。

Hermes をホワイトリストに登録するには:

• Windows Defender: 管理者として PowerShell を実行 → Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"
• Bitdefender: Bitdefender コンソールで例外を追加（Protection > Antivirus > Settings > Manage Exceptions）
• フォルダをホワイトリストに登録し、ファイルハッシュは登録しないでください — Hermes は uv を更新し、ハッシュはバージョンごとに変わります

詳細なコンテキストについては、上流の Astral レポートを参照してください: astral-sh/uv#13553、astral-sh/uv#15011、astral-sh/uv#10079。

はじめに

hermes              # インタラクティブ CLI — 会話を開始
hermes model        # LLM プロバイダーとモデルを選択
hermes tools        # 有効にするツールを設定
hermes config set   # 個々の設定値を設定
hermes config get   # 個々の設定値を表示
hermes gateway      # メッセージングゲートウェイを開始（Telegram、Discord など）
hermes setup        # 完全なセットアップウィザードを実行（すべてを一度に設定）
hermes claw migrate # OpenClaw から移行（OpenClaw から移行する場合）
hermes update       # 最新バージョンに更新
hermes doctor       # 問題を診断

📖 完全なドキュメント →

API キー収集をスキップ — Nous Portal

Hermes はお好みのプロバイダーで動作します — それは変わりません。ただし、モデル、ウェブ検索、画像生成、TTS、クラウドブラウザ用に 5 つの別々の API キーを収集したくない場合は、Nous Portal が 1 つのサブスクリプションでそれらすべてをカバーします:

• 300 以上のモデル — /model <name> で任意のモデルを選択
• ツールゲートウェイ — ウェブ検索（Firecrawl）、画像生成（FAL）、テキスト読み上げ（OpenAI）、クラウドブラウザ（Browser Use）、すべてサブスクリプション経由でルーティング。追加アカウント不要。

新規インストールからの 1 コマンド:

hermes setup --portal

これで OAuth 経由でログインし、Nous をプロバイダーとして設定し、ツールゲートウェイを有効にします。hermes portal info でいつでも接続状況を確認できます。詳細は ツールゲートウェイのドキュメントページ を参照してください。

ツールごとに独自のキーをいつでも持ち込むことができます — ゲートウェイはバックエンドごとであり、オールオアナッシングではありません。

CLI とメッセージングのクイックリファレンス

Hermes には 2 つのエントリポイントがあります: hermes でターミナル UI を開始するか、ゲートウェイを実行して Telegram、Discord、Slack、WhatsApp、Signal、または Email から話しかけます。会話に入ると、多くのスラッシュコマンドが両方のインターフェースで共有されます。

完全なコマンドリストについては、CLI ガイド と メッセージングゲートウェイガイド を参照してください。

ドキュメント

すべてのドキュメントは hermes-agent.nousresearch.com/docs にあります:

OpenClaw からの移行

OpenClaw から移行する場合、Hermes は設定、メモリ、スキル、API キーを自動的にインポートできます。

初回セットアップ時: セットアップウィザード（hermes setup）は ~/.openclaw を自動的に検出し、設定開始前に移行を提案します。

インストール後の任意のタイミング:

hermes claw migrate              # インタラクティブ移行（完全プリセット）
hermes claw migrate --dry-run    # 移行される内容をプレビュー
hermes claw migrate --preset user-data   # シークレットなしで移行
hermes claw migrate --overwrite  # 既存の競合を上書き

インポートされる内容:

• SOUL.md — ペルソナファイル
• メモリ — MEMORY.md と USER.md のエントリ
• スキル — ユーザー作成スキル → ~/.hermes/skills/openclaw-imports/
• コマンド許可リスト — 承認パターン
• メッセージング設定 — プラットフォーム設定、許可ユーザー、作業ディレクトリ
• API キー — 許可リストに登録されたシークレット（Telegram、OpenRouter、OpenAI、Anthropic、ElevenLabs）
• TTS アセット — ワークスペースのオーディオファイル
• ワークスペース指示 — AGENTS.md（--workspace-target 付き）

すべてのオプションについては hermes claw migrate --help を参照するか、openclaw-migration スキルを使用して、ドライラン プレビュー付きのインタラクティブなエージェントガイド移行を行ってください。

コントリビューション

コントリビューションを歓迎します！ 開発セットアップ、コードスタイル、PR プロセスについては コントリビューションガイド を参照してください。

コントリビューター向けクイックスタート — 標準インストーラーを使用し、それが作成する完全な git チェックアウト（$HERMES_HOME/hermes-agent、通常は ~/.hermes/hermes-agent）から作業します。これは hermes update、管理された venv、遅延依存関係、ゲートウェイ、ドキュメントツールで使用されるレイアウトと一致します。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
cd "${HERMES_HOME:-$HOME/.hermes}/hermes-agent"
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

手動クローンの代替（使い捨てクローン/CI で、管理されたインストールレイアウトを意図的に使用しない場合）:

クローンしたソースツリーの外に venv を作成します — エージェントが操作するディレクトリ内の venv は、エージェントが自身のチェックアウトに対して実行する相対パスコマンドによって消去され、実行中のランタイムがセッション中に破壊される可能性があります。

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv ~/.hermes/venvs/hermes-dev --python 3.11
source ~/.hermes/venvs/hermes-dev/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

コミュニティ

• 💬 Discord
• 📚 スキルハブ
• 🐛 問題
• 🔌 computer-use-linux — AT-SPI アクセシビリティツリー、Wayland/X11 入力、スクリーンショット、コンポジタウィンドウターゲティングを備えた、Hermes およびその他の MCP ホスト向けの Linux デスクトップ制御 MCP サーバー。
• 🔌 HermesClaw — コミュニティ WeChat ブリッジ: 同じ WeChat アカウントで Hermes Agent と OpenClaw を実行。

ライセンス

MIT — LICENSE を参照。

Nous Research によって構築されました。