<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7225/75e85ef6fecf5a6227985f2082e5b35331fceff4d8db03720c82a7d9ee8b7eea.png" alt="Hermes Agent" width="100%">
</p>
# Hermes Agent ☤
<p align="center">
<a href="https://hermes-agent.nousresearch.com/">Hermes Agent</a> | <a href="https://hermes-agent.nousresearch.com/">Hermes Desktop</a>
</p>
<p align="center">
<a href="https://hermes-agent.nousresearch.com/docs/"><img src="https://img.shields.io/badge/Docs-hermes--agent.nousresearch.com-FFD700?style=for-the-badge" alt="ドキュメント"></a>
<a href="https://discord.gg/NousResearch"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
<a href="https://github.com/NousResearch/hermes-agent/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="ライセンス: MIT"></a>
<a href="https://nousresearch.com"><img src="https://img.shields.io/badge/Built%20by-Nous%20Research-blueviolet?style=for-the-badge" alt="Nous Research による開発"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.zh-CN.md"><img src="https://img.shields.io/badge/Lang-%E4%B8%AD%E6%96%87-red?style=for-the-badge" alt="中文"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.ur-pk.md"><img src="https://img.shields.io/badge/Lang-%D8%A7%D8%B1%D8%AF%D9%88-green?style=for-the-badge" alt="اردو"></a>
<a href="https://github.com/nousresearch/hermes-agent/blob/main/README.es.md"><img src="https://img.shields.io/badge/Lang-Espa%C3%B1ol-orange?style=for-the-badge" alt="Español"></a>
</p>
**[Nous Research](https://nousresearch.com) が開発した自己改善型 AI エージェント。** 学習ループを内蔵した唯一のエージェントです — 経験からスキルを生成し、使用中にそれらを改善し、知識を永続化するよう自らを促し、自身の過去の会話を検索し、セッションをまたいであなたが誰であるかのモデルを深めていきます。月額5ドルの VPS、GPU クラスタ、またはアイドル時にはほぼ無料で済むサーバーレスインフラ上で実行できます。ラップトップに縛られません — クラウド VM で作業している間、Telegram から話しかけることができます。
好きなモデルを使用できます — [Nous Portal](https://portal.nousresearch.com)、OpenRouter、OpenAI、独自のエンドポイント、そして[その他多数](https://hermes-agent.nousresearch.com/docs/integrations/providers)。`hermes model` で切り替え — コード変更もロックインもありません。
<table>
<tr><td><b>本物のターミナルインターフェース</b></td><td>複数行編集、スラッシュコマンドのオートコンプリート、会話履歴、割り込みとリダイレクト、ストリーミングツール出力を備えた完全な TUI。</td></tr>
<tr><td><b>あなたのいる場所に住む</b></td><td>Telegram、Discord、Slack、WhatsApp、Signal、CLI — すべて単一のゲートウェイプロセスから。ボイスメモの文字起こし、クロスプラットフォームの会話継続性。</td></tr>
<tr><td><b>閉じた学習ループ</b></td><td>定期的なナッジを伴うエージェント管理のメモリ。複雑なタスク後の自律的なスキル作成。スキルは使用中に自己改善。クロスセッションの想起のための LLM 要約を伴う FTS5 セッション検索。 <a href="https://github.com/plastic-labs/honcho">Honcho</a> 弁証法的ユーザーモデリング。 <a href="https://agentskills.io">agentskills.io</a> オープン標準と互換。</td></tr>
<tr><td><b>スケジュールされた自動化</b></td><td>任意のプラットフォームへの配信を備えた組み込み cron スケジューラ。日次レポート、夜間バックアップ、週次監査 — すべて自然言語で、無人で実行。</td></tr>
<tr><td><b>委任と並列化</b></td><td>並列ワークストリーム用に分離されたサブエージェントを生成。デスクトップでは、設定 → モデル → サブエージェントでプロバイダー、モデル、制限を選択し、完全なルートを適用します。RPC 経由でツールを呼び出す Python スクリプトを書き、多段階のパイプラインをゼロコンテキストコストのターンに圧縮します。</td></tr>
<tr><td><b>ラップトップだけでなくどこでも実行</b></td><td>7つのターミナルバックエンド — ローカル、Docker、SSH、Singularity、Modal、Daytona、Vercel Sandbox。Daytona と Modal はサーバーレス永続性を提供 — エージェントの環境はアイドル時に休止し、オンデマンドで起動するため、セッション間のコストはほぼゼロです。月額5ドルの VPS または GPU クラスタで実行できます。</td></tr>
<tr><td><b>研究対応</b></td><td>バッチ軌跡生成、次世代のツール呼び出しモデルをトレーニングするための軌跡圧縮。</td></tr>
</table>
---
## クイックインストール
### Linux、macOS、WSL2
```bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```
### Windows（ネイティブ、PowerShell）
> **注意：** ネイティブ Windows では WSL なしで Hermes が動作します — CLI、ゲートウェイ、TUI、ツールはすべてネイティブに動作します。WSL2 を使用したい場合は、上記の Linux/macOS 用ワンライナーもそこで動作します。バグを見つけましたか？[issue を報告してください](https://github.com/NousResearch/hermes-agent/issues)。
PowerShell で以下を実行してください：
```powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```
ソースインストーラーは、Python 3.14、Node.js、npm、ripgrep、FFmpeg、およびPython依存関係の処理をPMに委任します。Gitが存在しない場合、検証済みのGit for WindowsアーカイブをHermesのツールストアにステージングします。システムのGitを置き換えることはありません。別個のMSIX/App Installerパッケージとその更新所有権については、[インストール方法](https://hermes-agent.nousresearch.com/docs/getting-started/installation)を参照してください。
> **Android / Termux:** aarch64デバイス向けに署名済みAPTリポジトリが利用可能で、`stable`チャネル（タグ付きリリース）とプレリリースの`canary`チャネルがあります。パッケージにはPython、Node.js、TUIが含まれます。デスクトップ/サーバーインストーラースクリプトではなく、[Termuxガイド](https://hermes-agent.nousresearch.com/docs/getting-started/termux)を使用してください。
>
> **Windows:** ネイティブWindowsは完全にサポートされています — 上記のPowerShellワンライナーで全てインストールされます。WSL2を使用したい場合、Linuxコマンドもそこで動作します。ネイティブWindowsインストールは`%LOCALAPPDATA%\hermes`配下に、WSL2インストールはLinuxと同様に`~/.hermes`配下に配置されます。
インストール後:
```bash
source ~/.bashrc # reload shell (or: source ~/.zshrc)
hermes # start chatting!
```
### トラブルシューティング
#### Windows Defender またはアンチウイルスが `uv.exe` をマルウェアとして検出する
アンチウイルス（Bitdefender、Windows Defender など）が Hermes の `bin` フォルダ（`%LOCALAPPDATA%\hermes\bin\uv.exe`）にある `uv.exe` を隔離した場合、これは**誤検知**です。このファイルは Astral の `uv` であり、Hermes が Python 環境を管理するために同梱している Rust 製 Python パッケージマネージャーです。機械学習ベースのアンチウイルスエンジンは、パッケージをダウンロードしてインストールする署名のない Rust バイナリを頻繁に検出します。
**コピーが本物であることを確認するには:**
```powershell
# Install GitHub CLI if needed
winget install --id GitHub.cli
# Login to GitHub
gh auth login
# Run verification
$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](https://github.com/astral-sh/uv/issues/13553)、[astral-sh/uv#15011](https://github.com/astral-sh/uv/issues/15011)、[astral-sh/uv#10079](https://github.com/astral-sh/uv/issues/10079)。
---
## はじめに
```bash
hermes # Interactive CLI — start a conversation
hermes model # Choose your LLM provider and model
hermes tools # Configure which tools are enabled
hermes config set # Set individual config values
hermes config get # Print individual config values
hermes gateway # Start the messaging gateway (Telegram, Discord, etc.)
hermes setup # Run the full setup wizard (configures everything at once)
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
hermes update # Update to the latest version
hermes doctor # Diagnose any issues
```
📖 **[完全なドキュメント →](https://hermes-agent.nousresearch.com/docs/)**
---
## APIキーの収集をスキップ — Nous Portal
Hermes は、ご希望のプロバイダーであればどれでも動作します — その点は変わりません。ただし、モデル、Web検索、画像生成、TTS、クラウドブラウザ用に5つの個別のAPIキーを集めるのを避けたい場合は、**[Nous Portal](https://portal.nousresearch.com)** がそれらすべてを1つのサブスクリプションでカバーします:
- **300以上のモデル** — `/model <name>` でいずれかを選択可能
- **Tool Gateway** — Web検索、画像生成 (FAL)、テキスト読み上げ (OpenAI)、クラウドブラウザ (Browser Use) がすべてサブスクリプション経由でルーティングされます。追加アカウントは不要です。
新規インストールからコマンド1つで:
```bash
hermes setup --portal
```
OAuth 経由でログインし、Nous をプロバイダーとして設定し、Tool Gateway を有効にします。接続状態はいつでも `hermes portal info` で確認できます。詳細は [Tool Gateway ドキュメントページ](https://hermes-agent.nousresearch.com/docs/user-guide/features/tool-gateway) をご覧ください。
ツールごとに独自のキーを持ち込むこともいつでも可能です — ゲートウェイはバックエンド単位であり、オール・オア・ナッシングではありません。
---
## CLI とメッセージングのクイックリファレンス
Hermes には 2 つのエントリーポイントがあります。`hermes` でターミナル UI を起動するか、ゲートウェイを実行して Telegram、Discord、Slack、WhatsApp、Signal、Email から会話します。一度会話に入れば、多くのスラッシュコマンドは両方のインターフェースで共通です。
| アクション | CLI | メッセージングプラットフォーム |
| ------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- |
| チャットを開始 | `hermes` | `hermes gateway setup` + `hermes gateway start` を実行し、ボットにメッセージを送信 |
| 新しい会話を開始 | `/new` または `/reset` | `/new` または `/reset` |
| モデルを変更 | `/model [provider:model]` | `/model [provider:model]` |
| パーソナリティを設定 | `/personality [name]` | `/personality [name]` |
| 直前のターンを再試行または取り消し | `/retry`、`/undo` | `/retry`、`/undo` |
| コンテキストを圧縮 / 使用量を確認 | `/compress`、`/usage`、`/insights [--days N]` | `/compress`、`/usage`、`/insights [days]` |
| スキルを閲覧 | `/skills` または `/<skill-name>` | `/<skill-name>` |
| 現在の作業を中断 | `Ctrl+C` または新しいメッセージを送信 | `/stop` または新しいメッセージを送信 |
| プラットフォーム固有のステータス | `/platforms` | `/status`、`/sethome` |
コマンドの完全な一覧については、[CLI ガイド](https://hermes-agent.nousresearch.com/docs/user-guide/cli) と [メッセージングゲートウェイガイド](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) をご覧ください。
---
## ドキュメント
すべてのドキュメントは **[hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs/)** にあります:
| セクション | 内容 |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [クイックスタート](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) | インストール → セットアップ → 2分で最初の会話 |
| [CLI の使い方](https://hermes-agent.nousresearch.com/docs/user-guide/cli) | コマンド、キーバインド、パーソナリティ、セッション |
| [設定](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) | 設定ファイル、プロバイダー、モデル、すべてのオプション |
| [メッセージングゲートウェイ](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) | Telegram、Discord、Slack、WhatsApp、Signal、Home Assistant |
| [セキュリティ](https://hermes-agent.nousresearch.com/docs/user-guide/security) | コマンド承認、DM ペアリング、コンテナ分離 |
| [ツールとツールセット](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) | 40以上のツール、ツールセットシステム、ターミナルバックエンド |
| [スキルシステム](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) | 手続き型メモリ、Skills Hub、スキルの作成 |
| [メモリ](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory) | 永続メモリ、ユーザープロファイル、ベストプラクティス |
| [MCP 統合](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) | 機能を拡張するために任意の MCP サーバーを接続 |
| [Cron スケジューリング](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) | プラットフォーム配信を伴うスケジュールタスク |
| [コンテキストファイル](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files) | すべての会話を形作るプロジェクトコンテキスト |
| [アーキテクチャ](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) | プロジェクト構造、エージェントループ、主要クラス |
| [コントリビューション](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) | 開発環境のセットアップ、PR プロセス、コードスタイル |
| [CLI リファレンス](https://hermes-agent.nousresearch.com/docs/reference/cli-commands) | すべてのコマンドとフラグ |
| [環境変数](https://hermes-agent.nousresearch.com/docs/reference/environment-variables) | 環境変数の完全リファレンス |
---
## OpenClaw からの移行
OpenClaw から移行する場合、Hermes は設定、メモリ、スキル、API キーを自動的にインポートできます。
**初回セットアップ時:** セットアップウィザード（`hermes setup`）は `~/.openclaw` を自動的に検出し、設定を開始する前に移行を提案します。
**インストール後いつでも:**
```bash
hermes claw migrate # Interactive migration (full preset)
hermes claw migrate --dry-run # Preview what would be migrated
hermes claw migrate --preset user-data # Migrate without secrets
hermes claw migrate --overwrite # Overwrite existing conflicts
```
インポートされる内容:
- **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 のプロセスについては [コントリビューションガイド](https://hermes-agent.nousresearch.com/docs/developer-guide/contributing) を参照してください。
アクティベーション、日常的な使用、依存関係の変更、環境からの退出については、まず [PM 開発者ワークフロー](https://github.com/nousresearch/hermes-agent/blob/main/website/docs/reference/package-management.md#developer-workflow) から始めてください。
[開発環境のセットアップ](https://github.com/nousresearch/hermes-agent/blob/main/CONTRIBUTING.md#development-setup) では、別個のテスト環境と検証コマンドについて説明しています。
---
## コミュニティ
- 💬 [Discord](https://discord.gg/NousResearch)
- 📚 [Skills Hub](https://agentskills.io)
- 🐛 [Issues](https://github.com/NousResearch/hermes-agent/issues)
- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — Hermes やその他の MCP ホスト向けの Linux デスクトップ制御 MCP サーバー。AT-SPI アクセシビリティツリー、Wayland/X11 入力、スクリーンショット、コンポジタのウィンドウターゲティングを備えています。
- 🔌 [HermesClaw](https://github.com/AaronWong1999/hermesclaw) — コミュニティ製の WeChat ブリッジ: 同じ WeChat アカウント上で Hermes Agent と OpenClaw を実行できます。
---
## ライセンス
MIT — [LICENSE](https://github.com/nousresearch/hermes-agent/blob/main/LICENSE) を参照してください。
[Nous Research](https://nousresearch.com) によって構築されています。
