hermes-agent

Hermes Agent

Hermes Agent は、Nous Research が開発したオープンソースの AI エージェントフレームワークです。ターミナル、ネイティブのデスクトップアプリ、メッセージングプラットフォーム、IDE で実行できます。Claude Code（Anthropic）、Codex（OpenAI）、OpenClaw と同じカテゴリに属し、ツール呼び出しを使ってシステムとやり取りする自律型のコーディングおよびタスク実行エージェントです。Hermes はあらゆる LLM プロバイダー（OpenRouter、Anthropic、OpenAI、Google、DeepSeek、xAI、ローカルモデルなど、20 以上）に対応し、Linux、macOS、Windows、WSL で動作します。

Hermes の特徴：

• スキルを通じた自己改善 — 再利用可能な手順をスキルとして保存し、今後のセッションで読み込むことで、経験から学習します。
• セッションをまたぐ永続的なメモリ — ユーザーのこと、好み、環境の詳細、学んだ教訓を記憶します。メモリバックエンドはプラグインで追加できます。
• マルチプラットフォームゲートウェイ — 同じエージェントが Telegram、Discord、Slack、WhatsApp、iMessage、Signal、Matrix、Teams、Email など、さらに十数種類のプラットフォームで、チャットだけでなくすべてのツールにアクセスしながら動作します。
• 多様なインターフェース — 同じエージェントのコアが、CLI、Ink TUI、ネイティブの Electron デスクトップアプリ、ウェブダッシュボード、IDE 用の ACP サーバー（VS Code / Zed / JetBrains）を動かします。
• プロバイダーに依存しない設計 — ワークフローの途中でモデルやプロバイダーを切り替えられます。認証情報プールが複数の API キーを自動的にローテーションします。
• プロファイル — 設定、セッション、スキル、メモリを分離した Hermes の独立したインスタンスを複数実行できます。
• 拡張可能でテーマを変更可能 — プラグイン、MCP サーバー、カスタムツール、Webhook トリガー、cron スケジューリング、すべてのインターフェースにテーマを適用するスキン、デスクトップ UI プラグイン、TUI ウィジェット、ペットマスコットに対応しています。

このスキルはハブです。 本文では、基本情報、クイックスタート、生成とオーケストレーション、厳守すべき不変条件を扱います。それ以外の内容はすべてリファレンスファイルにあります。回答する前に、該当するリファレンス（下記）を読み込んでください。本文だけを根拠に詳細な質問へ回答しないでください。

ドキュメント： https://hermes-agent.nousresearch.com/docs/

対象範囲と検証

このスキルは簡潔な操作ガイドであり、Hermes のすべての機能に関する完全な情報源ではありません。Hermes の機能、コマンド、設定がここやリファレンスに記載されていなくても、それだけで存在しないと判断しないでください。否定的な回答をする前に、最新のリポジトリと公式ドキュメントを確認してください。

確認先の候補（手間の少ない順）：

• 提供されているすべての機能を、それぞれ 1 行で記載：https://hermes-agent.nousresearch.com/docs/llms.txt。 「Hermes は X ができますか？」や「X を行うにはどうすればよいですか？」という質問では、まずここを確認してください。回答が記載されたページへのリンクとともに、ドキュメント一式を一覧できます。ビルドのたびにドキュメントツリーから生成されるため、製品の最新情報が反映されています。web_extract で取得するか、ウェブツールが使えない場合は curl -s https://hermes-agent.nousresearch.com/docs/llms.txt を実行してください。ドキュメント一式をまとめたファイルは /docs/llms-full.txt にあります。
• CLI コマンド：hermes --help、hermes <command> --help、hermes_cli/main.py
• ソースツリー：https://github.com/NousResearch/hermes-agent

記憶だけを頼りに「Hermes にはできません」と回答しないでください。Hermes が提供する機能は、このスキルの本文に記載された内容をはるかに超えています。否定的な回答をいつでも確認できるよう、インデックスが用意されています。

クイックスタート

# Install (shell installer — bootstraps PM, Python, dependencies, and the launcher)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# Interactive chat (default surface; set display.interface: tui to launch the Ink TUI instead)
hermes

# Single query
hermes chat -q "What is the capital of France?"

# Setup wizard  /  pick model+provider  /  health check
hermes setup
hermes model
hermes doctor

# Other surfaces
hermes desktop                 # launch the native desktop app (alias: hermes gui)
hermes dashboard               # web admin panel + embedded chat
hermes proxy                   # OpenAI-compatible local proxy backed by your OAuth provider

主要なパス

~/.hermes/config.yaml       Main configuration (settings — never secrets)
~/.hermes/.env              API keys and secrets ONLY (under $HERMES_HOME if set)
$HERMES_HOME/skills/        Installed skills
~/.hermes/skins/            Custom themes (see references/themes.md)
~/.hermes/desktop-plugins/  Desktop app UI plugins (see references/desktop-plugins.md)
~/.hermes/tui-widgets/      TUI widget apps (see references/tui-widgets.md)
~/.hermes/pets/             Installed pet mascots (see references/petdex.md)
~/.hermes/state.db          Canonical session store (SQLite + FTS5)
~/.hermes/sessions/         Gateway routing index, request dumps, *.jsonl transcripts
~/.hermes/logs/             Gateway and error logs
~/.hermes/auth.json         OAuth tokens and credential pools
~/.hermes/hermes-agent/     Source code (if git-installed)

プロファイルでは、同じ構成の ~/.hermes/profiles/<name>/ を使用します。プロファイルがアクティブな場合は、$HERMES_HOME から実際のホームディレクトリを解決してください。~/.hermes をハードコードしないでください。

ルーティングテーブル — タスクに応じてリファレンスを読み込む

ユーザーの要望	読み込むもの
以下に記載のないこと — 「Hermes で X はできますか？」「X の設定方法を教えてください」	https://hermes-agent.nousresearch.com/docs/llms.txt
チャット、ルーティンの実行、相互のメッセージ送信を行うボット、Bots タブ	docs: /user-guide/bot-mode
CLI コマンド、サブコマンド、フラグ、「X の実行方法」	references/cli-reference.md
セッション内のスラッシュコマンド	references/slash-commands.md
プロバイダーの設定、API キー、OAuth	references/providers-and-models.md
config.yaml のセクション、ツールセット、音声／STT／TTS	references/configuration.md
AGENTS.md / .hermes.md / CLAUDE.md のプロジェクトルール	references/project-context-files.md
シークレットのマスキング、PII、承認モード、「権限のリセット」	references/security-privacy.md
委任、cron、キュレーター、カンバン	references/background-systems.md
MCP サーバー（追加、カタログ、hermes mcp）	references/native-mcp.md
Webhook のルートとイベント駆動型の実行	references/webhooks.md
カスタムテーマ／スキン（「シンセウェーブテーマ」、「金色の ● を変更」）	references/themes.md + templates/skin.yaml
デスクトップアプリの UI 要素（ペイン、ウィジェット、⌘K コマンド、ページ）	references/desktop-plugins.md + templates/plugin.js
ライブ TUI パネルやモーダルウィジェット（ティッカー、時計、ダッシュボード）	references/tui-widgets.md + templates/clock.mjs
ペットマスコット — インストール、選択、サイズ変更、診断	references/petdex.md
Windows 固有の問題（キー割り当て、WinError 10106、BOM）	references/windows-quirks.md
デバッグ：音声、ツールが見つからない、ゲートウェイ、補助モデル	references/troubleshooting.md
コードへの貢献：ツール、スラッシュコマンド、テストの追加	references/contributor-guide.md
delegate_task の「上限 N 件」レポート	references/delegate-task-concurrency-diagnosis.md
「アプリ X で Nous Portal のサブスクリプション／OAuth を使えますか？」	references/portal-auth-for-third-party-apps.md
メッセージングプラットフォームへの接続（Telegram、Discord、Slack、WhatsApp など）	docs: /user-guide/messaging

上記のリファレンス一覧は機能一覧ではありません。ドキュメントページだけでは不十分なトピックをまとめています。Hermes のその他すべての機能については、llms.txt を取得すると、質問への回答が記載されたページがわかります。

リファレンスを読み込まなくても適用されるテーマ設定のルールが 2 つあります。スキンはユーザー自身が適用します（hermes config set display.skin <name> — 約 1 秒以内にすべての画面がリアルタイムで再描画されます。ユーザーに /skin を実行するよう案内しないでください）。また、1 色だけ調整する場合は、現在有効なスキンを編集します（hermes skin set <key> <hex>）。パレットが失われ、背景がリセットされるため、default を複製してはいけません。

Hermes のインスタンスを追加で起動する

Hermes のプロセスを追加で起動する場合は、セッション、ツール、環境がそれぞれ独立したサブプロセスとして実行してください。

delegate_task と使い分ける場合

	delegate_task	hermes プロセスの起動
分離性	会話は別、プロセスは共有	プロセスが完全に独立
実行時間	数分（親ループによる制限あり）	数時間／数日
ツールへのアクセス	親のツールの一部	すべてのツールにアクセス可能
対話性	なし	あり（PTY モード）
用途	短時間の並列サブタスク	長時間の自律的なミッション

ワンショットモード

terminal(command="hermes chat -q 'Research GRPO papers and write summary to ~/research/grpo.md'", timeout=300)

# Background for long tasks:
terminal(command="hermes chat -q 'Set up CI/CD for ~/myapp'", background=true)

対話型 PTY モード（tmux 経由）

Hermes は prompt_toolkit を使用しているため、実際のターミナルが必要です。対話型の起動には tmux を使用します。

# Start
terminal(command="tmux new-session -d -s agent1 -x 120 -y 40 'hermes'", timeout=10)

# Wait for startup, then send a message
terminal(command="sleep 8 && tmux send-keys -t agent1 'Build a FastAPI auth service' Enter", timeout=15)

# Read output
terminal(command="sleep 20 && tmux capture-pane -t agent1 -p", timeout=5)

# Send follow-up
terminal(command="tmux send-keys -t agent1 'Add rate limiting middleware' Enter", timeout=5)

# Exit
terminal(command="tmux send-keys -t agent1 '/exit' Enter && sleep 2 && tmux kill-session -t agent1", timeout=10)

マルチエージェントの調整

# Agent A: backend
terminal(command="tmux new-session -d -s backend -x 120 -y 40 'hermes -w'", timeout=10)
terminal(command="sleep 8 && tmux send-keys -t backend 'Build REST API for user management' Enter", timeout=15)

# Agent B: frontend
terminal(command="tmux new-session -d -s frontend -x 120 -y 40 'hermes -w'", timeout=10)
terminal(command="sleep 8 && tmux send-keys -t frontend 'Build React dashboard for user management' Enter", timeout=15)

# Check progress, relay context between them
terminal(command="tmux capture-pane -t backend -p | tail -30", timeout=5)
terminal(command="tmux send-keys -t frontend 'Here is the API schema from the backend agent: ...' Enter", timeout=5)

セッションの再開

# Resume most recent session
terminal(command="tmux new-session -d -s resumed 'hermes --continue'", timeout=10)

# Resume specific session
terminal(command="tmux new-session -d -s resumed 'hermes --resume 20260225_143052_a1b2c3'", timeout=10)

ヒント

• 手早いサブタスクには delegate_task を優先してください — 完全なプロセスを起動するよりオーバーヘッドが少なくなります
• コードを編集するエージェントを起動するときは -w（worktree モード）を使用してください — Git の競合を防げます
• ワンショットモードではタイムアウトを設定してください — 複雑なタスクには 5〜10 分かかる場合があります
• 投げっぱなしの処理には hermes chat -q を使用してください — PTY は不要です
• 対話型セッションには tmux を使用してください — 生の PTY モードでは、prompt_toolkit で \r と \n の問題が発生します
• スケジュールされたタスクには、エージェントを起動する代わりに cronjob ツールを使用してください — 配信と再試行に対応しています
• 「delegate_task is capped at N」という報告 — references/delegate-task-concurrency-diagnosis.md を参照してください。Hermes には実際の上限経路が 3 つあります。どれも発動していない場合、モデルが自ら制限し、それを「ランタイムの上限」と合理化しています。
• 「$external_app は自分の Nous Portal サブスクリプション／OAuth を使えますか？」 — references/portal-auth-for-third-party-apps.md を参照してください。3 つの層（プラグインとアプリの違い、Portal が実際に公開しているもの、ローカルブローカープロキシの選択肢）についてユーザーに説明してください。

インターフェース（概要）

• デスクトップアプリ（hermes desktop / hermes gui） — macOS/Linux/Windows 向けのネイティブ Electron アプリです。ストリーミングチャット、セッション一覧、Cmd+K パレット、ファイルのドラッグ＆ドロップ、ネイティブ通知、プロファイルごとのリモートゲートウェイログインに対応しています。UI プラグインで拡張できます — references/desktop-plugins.md。
• Web ダッシュボード（hermes dashboard） — メッセージングチャネル、MCP カタログ、Web フック、メモリ、プロファイルビルダーに加え、hermes --tui チャットを埋め込んだ総合管理パネルです。OAuth／トークンゲートで保護されています。
• Ink TUI（hermes --tui または display.interface: tui） — ドック表示のウィジェットアプリを備えたターミナル UI です — references/tui-widgets.md。
• OpenAI 互換プロキシ（hermes proxy） — サインイン中の OAuth プロバイダーをバックエンドとするローカル OpenAI API です。API キーなしで、Codex CLI、Aider、Cline、または任意のスクリプトから接続できます。

厳守事項（読み込んだ内容にかかわらず、決して違反しないこと）

• プロンプトキャッシュを決して壊さないでください — 会話の途中で、過去のコンテキスト、ツールセット、システムプロンプトを変更しないでください。唯一の例外はコンテキスト圧縮です。
• メッセージロールの交互性 — assistant メッセージや user メッセージを連続させないでください。繰り返せるのは tool の結果のみです。
• .env にはシークレット、config.yaml には設定を記述してください — 認証情報以外の設定を .env に入れるよう、ユーザーに決して指示しないでください。
• プロファイルに安全なパスを使用してください — コードでは get_hermes_home()、セッション内でパスを解決するときは $HERMES_HOME を使用してください。
• ユーザーに代わって config.yaml を直接編集しないでください — hermes config set KEY VAL を使用してください。インデントのずれでファイルが破損し、稼働中のゲートウェイが停止するおそれがあります。