結論
Hermes Agent(ハーメス エージェント)は、Nous Research が MIT ライセンスで公開しているオープンソースの AI エージェントです。端末・デスクトップアプリ・Telegram や Slack などから話しかけると、選んだ AI モデルを使ってコマンド実行・Web 検索・ファイル操作をこなし、うまくいった手順を「スキル」として自分で保存していきます。Linux・macOS・WSL2 では curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash で入ります。
この記事でわかること
- できること・動作環境・料金(Nous Portal)と、同じ名前の「Hermes」モデルとの違い
- 入れ方・初期設定・最初の会話までの手順と、よくあるつまずき
- 公式リポジトリを取得して数えた中身(同梱スキル44個・設定の29項目・日本語の画面文言)
この記事で実際に動かしたもの:公式リポジトリ(github.com/NousResearch/hermes-agent)の取得と、中身を数える自作の Python スクリプト(ファイル構成・同梱スキル・設定ファイルの見本・画面文言の翻訳)。Hermes Agent 本体は起動していません。
Hermes Agent は、1つの「エージェント本体」に、入口(端末やチャットアプリ)、頭脳になる AI モデル、手足になるツールがつながり、作業で分かった手順や利用者の好みをスキルとメモリーに保存していく作りです。下の図は、README と公式ドキュメントの説明をまとめたものです。
flowchart TD
A[入口<br>CLI・TUI・Desktop・チャット] --> B[Hermes Agent 本体]
B --> C[AIモデル<br>API・ローカル]
B --> D[ツール<br>端末・Web]
C --> E[スキルとメモリーに<br>手順と好みを保存]
D --> E
よく調べられることの答えを先にまとめます。
| 知りたいこと | 答え | 詳しい節 |
|---|---|---|
| Hermes Agent とは | Nous Research のオープンソース AI エージェント。使いながらスキルとメモリーをためる | Hermes Agentとは |
| Hermes Agent で何ができる | 端末操作・Web 検索・ブラウザ操作・定期実行・サブエージェントへの分担・チャットアプリからの操作 | できること |
| Hermes Agent は無料か | 本体は MIT ライセンスで無料。AI モデルの利用料は別(自分の API キーか Nous Portal) | 動作環境と料金 |
| Hermes Agent の入れ方 | Linux・macOS・WSL2 は install.sh、Windows は PowerShell の install.ps1、またはデスクトップアプリ | 入れ方 |
| Hermes Agent の使い方 | hermes model でモデルを選び、hermes か hermes --tui で話しかける |
使い方 |
| 使えるモデル | Nous Portal・OpenRouter・Anthropic・OpenAI Codex・Gemini・ローカル(Ollama など)。文脈長 64,000 トークン以上が条件 | 対応するモデル |
| Hermes モデルとの違い | Hermes 4 などは Nous Research の言語モデル。Hermes Agent はそれを含む各社のモデルを動かす側のソフト | Hermesモデルとの違い |
| 日本語で使えるか | 会話は選んだモデルしだい。画面の文言には日本語の翻訳ファイルが同梱されている | 日本語で使うには |
| アンインストール | hermes uninstall --dry-run で確かめてから hermes uninstall |
入れ方 |
確認環境:Ubuntu 24.04.5 LTS の上で、git 2.43.0 を使って公式リポジトリ(github.com/NousResearch/hermes-agent)の main ブランチを取得し(コミット 9431f2e、2026年11月15日)、Python 3.13.18 と PyYAML 6.0.3 の自作スクリプトで中身を集計しました(追跡されているファイルの数とフォルダーごとの内訳、同梱スキルの SKILL.md の数・カテゴリ・frontmatter の項目・行数、設定ファイルの見本 cli-config.yaml.example の項目、画面文言の翻訳ファイルのキーの数)。公開中の最新リリースは GitHub のリリース一覧で確かめた v0.22.5(2026年10月22日)で、取得した main はそれより新しい開発中の状態です。このマシンでは Hermes Agent を起動しておらず、インストーラーも実行していません。AI のモデルも呼んでいません。アカウントの作成・ログインもしていません。GitHub の API でのリリース情報の取得はこの環境の権限で拒否されたため、リリース一覧は公開ページで読みました。インストール・初期設定・画面の動き・料金は、公式サイト(hermes-agent.nousresearch.com)、公式ドキュメント(同 /docs)、README、Nous Portal の公開ページの記載で書いています(確認日 2026年11月16日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Hermes Agentとは|入れ方・使い方・料金と同梱スキル44個」
Hermes Agentとは(Nous ResearchのAIエージェント)
この節では、Hermes Agent がどんなソフトで、誰が作っているのかが分かります。
README は Hermes Agent を「Nous Research が作った、自分で改善していく AI エージェント」と紹介しています。特徴として挙げているのは「学習のループ」です。複雑な作業のあとで手順をスキルとして保存し、使いながら直し、過去の会話を検索し、セッションをまたいで利用者の好みを覚えていく、という流れです。
公式サイトは「メモリーとスキルを持つ、無料でオープンソースの AI エージェント」と説明し、Mac・Windows・Linux で動くとしています。作者の Nous Research は、公式サイトで自らを「オープンな AI の学習と研究の先駆け」と紹介している団体で、リポジトリの LICENSE には「Copyright (c) 2025 Nous Research」と書かれています。
基本の情報を表にまとめます。
| 項目 | 内容(2026年11月16日時点) | 確かめた場所 |
|---|---|---|
| 提供元 | Nous Research, Inc. | 公式サイト・LICENSE |
| ライセンス | MIT License | LICENSE・pyproject.toml |
| 最新リリース | v0.22.5(2026年10月22日) | GitHub のリリース一覧 |
| 主な言語 | Python(3.14 で動かす前提)と TypeScript(画面まわり) | pyproject.toml・ファイルの拡張子 |
| 入口 | CLI・TUI・Hermes Desktop・Telegram・Discord・Slack・WhatsApp・Signal・メール | README・公式サイト |
| データの置き場所 | ~/.hermes/(Windows は %LOCALAPPDATA%\hermes\) |
公式ドキュメント Installation |
「エージェント」は、指示を受けて自分で手順を考え、ツールを呼び、結果を見て次の手を決めるプログラムのことです。考え方の土台は関連記事「AIエージェントとは|仕組みとワークフローとの違い・作り方入門」で扱っています。
Hermes Agentでできること(主な機能)
この節では、Hermes Agent の主な機能が、README と公式サイトの分け方のとおりに分かります。
公式サイトは機能を「つなぐ・覚える・予定を組む・任せる・調べる・試す」の6つに分けています。それぞれの説明を日本語にまとめます。
1つなぐ(Connect)
Telegram・Discord・Slack・WhatsApp・Signal・メール・CLI から話しかけられる。1つのゲートウェイのプロセスでまとめて受け付ける。
2覚える(Remember)
プロジェクトのことを覚え、スキルを自動で作り、問題をどう解いたかを残す。
3予定を組む(Schedule)
報告・バックアップ・定例のまとめを、自然な文章で定期実行に登録できる。組み込みの cron スケジューラーを使う。
4任せる(Delegate)
会話と端末を分けたサブエージェントを作って並行して進める。ツールを呼ぶ Python スクリプトで手順をまとめることもできる。
5調べる(Search)
Web 検索・ブラウザ操作・画像の読み取り・画像生成・読み上げ・複数のモデルを使った推論。
6試す(Experiment)
コマンドを動かす場所を、手元・Docker・SSH 先・クラウドのサンドボックスなどから選べる。
コマンドを実行する場所(ターミナルのバックエンド)は、公式ドキュメント「Tools & Toolsets」に local(既定)・docker・ssh・modal・daytona・vercel_sandbox と、プラグインで足す singularity・sprites が並んでいます。手元の PC で直接動かすか、コンテナや別のマシンの中で動かすかを、設定ファイルの terminal.backend で切り替えます。
外部のツールは MCP(Model Context Protocol)でつなげます。公式ドキュメントによると、MCP サーバーのツールは mcp-<サーバー名> という名前のツールセットとして並びます。MCP の仕組みは関連記事「MCPとは?サーバーとクライアントの仕組みと設定例を図解」で扱っています。
Hermes AgentとHermesモデルの違い・読み方
ここでは、名前が似ている「Hermes」の言語モデルと Hermes Agent の関係と、読み方の扱いが分かります。
Hermes(言語モデル)
Nous Research が公開している言語モデルの系列
公式フォーラムで Hermes 4 を「最新のオープンソースのモデルの系列」と発表
文章を読んで文章を返す「頭脳」の側
Hermes Agent(エージェント)
モデルを呼び出して作業を進めるソフト
Hermes モデル専用ではなく、各社のモデルを選べる
ツール・スキル・メモリー・入口を持つ「手足と記憶」の側
Hermes Agent を使うのに Hermes モデルは要りません。README は「Nous Portal・OpenRouter・OpenAI・自分のエンドポイントなど、好きなモデルを使える」と書き、hermes model でコードを変えずに切り替えられるとしています。取得した設定ファイルの見本では、既定のモデルの例として anthropic/claude-opus-4.6 が書かれていました。
読み方は、公式の文書には書かれていませんでした。日本語の記事では「ハーメス」「ヘルメス」の両方が使われていて、どちらで検索しても同じ製品の情報にたどり着きます。
Hermes Agentの動作環境と料金(Nous Portal)
この節では、Hermes Agent を動かせる OS と、無料で使える範囲・お金がかかるところが分かります。
本体は無料ですが、AI モデルの利用料は別にかかります。モデルは、自分で契約した各社の API キーを使うか、Nous Research の有料サービス「Nous Portal」を使うか、手元の PC で動かすローカルモデルを使うかを選びます。
| 環境 | 公式の記載(2026年11月16日時点) |
|---|---|
| Linux・WSL2 | install.sh で入る。Git・curl・tar・SHA-256 のコマンドが要る |
| macOS | インストーラーは Apple Silicon のみ。デスクトップアプリは macOS 12 以降(.dmg) |
| Windows | WSL なしでそのまま動く。PowerShell の install.ps1、またはデスクトップアプリ(Windows 10・11) |
| Android | Termux の APT リポジトリから pkg install hermes-agent(aarch64) |
| Python | 公式のインストールは Python 3.14 で動く。インストーラーが用意する |
| モデル | 文脈長(コンテキスト)が 64,000 トークン以上のモデルが必要。足りないモデルは起動時に断られる |
Nous Portal の料金は、公開ページに次のように書かれていました。モデル 200 以上を1つの契約で使え、Web 検索・画像生成・ブラウザ操作・読み上げなどのツールも同じ残高から使えます(ツールは1回ごとの料金)。
Free $0
無料のモデルだけ。月のクレジットは $0。
標準の回数制限
Plus 月 $20
Hermes Agent での利用が日・週・月の上限つきで含まれる。クラウドのエージェント(メモリー 4GB・ディスク 25GB)つき。
高いモデルほど早く減る
Super 月 $100
Plus と同じ使い方で、クラウドのエージェントのディスクが 100GB。
利用の枠は Plus と同じ書き方
Ultra 月 $200
クラウドのエージェントがメモリー 8GB・ディスク 100GB。
API キー経由はクレジット払い
クレジットは $10・$20・$50・$100・$200 から追加でき、API キー経由の利用は契約に含まれる枠ではなくクレジットから引かれる、と書かれています。料金と枠は変わることがあるので、契約の前に Nous Portal の最新のページで確かめます。各社の API キーを使う場合は、その会社の料金がかかります。
Hermes Agentの入れ方(インストール)
この節では、OS ごとのインストールのコマンドと、入る場所・更新・アンインストールの方法が分かります。
公式の入れ方は、端末に1行のコマンドを貼る方法と、デスクトップアプリを入れる方法の2つです。どちらも公式ドキュメント「Installation」と README に書かれています。
# Linux・macOS・WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
# 入ったあと、シェルを読み込み直して起動
source ~/.bashrc # zsh なら source ~/.zshrc
hermes
# Windows(PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
「curl … | bash」は、ダウンロードしたスクリプトをそのまま実行する書き方です。中身を先に読みたい場合は、いったんファイルに保存して読んでから実行します。公式ドキュメントによると、インストーラーは次のことをします。
ソースを取得する
Hermes Agent のソースを取得する。既定は最新の安定版(stable)。開発中の main を追う場合は --channel main。
道具をそろえる
uv を用意し、固定した版の Python・Node.js・npm・pnpm・ripgrep・FFmpeg を入れる。
ブラウザまわりを入れる
ブラウザ操作とコンピューター操作のツールを既定で入れる。要らなければ --skip-browser・--skip-computer-use。
記録を残す
インストールの記録を、データの置き場所の logs/install.log に書く。
取得した scripts/install.sh の引数の処理を読むと、ほかに --dir(入れる場所)・--hermes-home(データの置き場所)・--non-interactive(質問しない)・--include-desktop(デスクトップアプリも入れる)などの引数がありました。
入る場所は、公式ドキュメントの表のとおりです。
| 入れ方 | プログラム | 起動コマンド | データ |
|---|---|---|---|
| Linux・macOS のソース | ~/.hermes/hermes-agent/ |
~/.local/bin/hermes |
~/.hermes/ |
| Windows のソース | %LOCALAPPDATA%\hermes\hermes-agent\ |
%LOCALAPPDATA%\hermes\bin\ |
%LOCALAPPDATA%\hermes\ |
| Docker | /opt/hermes/ |
イメージの起動処理 | /opt/data/ |
| Termux | $PREFIX/lib/hermes-agent/ |
$PREFIX/bin/ |
~/.hermes/ |
デスクトップアプリ(Hermes Desktop)は、公式サイトから OS ごとのパッケージを取得します。macOS は DMG を開いて Hermes.app を「アプリケーション」に入れ、Windows は .appinstaller を Windows の App Installer で開くか Microsoft Store から入れます。CLI だけ入れたあとで hermes desktop を実行する方法もあります。
更新とアンインストール
公式ドキュメント「Updating & Uninstalling」の記載です。
hermes update # 更新(--check で確かめるだけ)
hermes backup # 消す前にバックアップ
hermes uninstall --dry-run # 何が消えるかを先に見る
hermes uninstall # 既定は設定とデータを残せる
hermes uninstall --full # データも消す
デスクトップアプリはアプリ内の更新の操作で更新し、Microsoft Store 版は Windows の設定の「アプリ」から、macOS 版はアプリをゴミ箱に入れて消します。Docker で動かしている場合は docker pull nousresearch/hermes-agent:latest で新しいイメージを取得し、同じデータの置き場所をつないでコンテナを作り直します。
Hermes Agentの使い方(初期設定と最初の会話)
この節では、入れたあとにモデルを選び、最初の会話が通るまでの手順が分かります。
公式のクイックスタートの考え方は「普通の会話が1回通るまで、機能を足さない」です。ゲートウェイ・定期実行・スキル・音声は、会話が通ってから足します。
モデルを選ぶ
hermes model でプロバイダーとモデルを対話形式で選ぶ。Nous Portal を使うなら hermes setup --portal でログイン・プロバイダーの設定・ツールのゲートウェイの有効化までまとめて進む。
起動する
hermes(従来の CLI)か hermes --tui(公式が勧める TUI)で起動する。最初の画面に、選んだモデルとプロバイダーが出れば設定が効いている。
確かめやすい頼みごとをする
公式の例は「このリポジトリを5つの箇条書きで要約し、入口のファイルを教えて」。答えが正しいかを自分で確かめられる内容にする。
続きから再開する
hermes --continue(hermes -c)で直前のセッションに戻れるかを確かめる。
README に並ぶ主なコマンドと、会話の中で使うスラッシュコマンドをまとめます。
| コマンド | 働き |
|---|---|
hermes | 対話の CLI を起動して会話する |
hermes model | プロバイダーとモデルを選ぶ |
hermes tools | 使うツールを選ぶ(入口ごとに設定できる) |
hermes config set・get | 設定を1項目ずつ変える・読む |
hermes gateway | Telegram・Discord などのゲートウェイを起動する |
hermes setup | 設定のウィザードをまとめて進める |
hermes doctor | うまく動かない原因を調べる |
/new・/model・/undo | 会話の中で、新しい会話・モデルの切り替え・直前の取り消し |
/skills・/usage・/compress | スキルの一覧・使用量の確認・文脈の圧縮 |
チャットアプリから使う場合は、hermes gateway setup と hermes gateway start のあとでボットにメッセージを送ります。公式ドキュメント「Security」によると、知らない相手からのメッセージには1回限りのペアリングコードが送られ、ボットの持ち主が CLI で承認するまで使えません(コードは1時間で切れ、5回失敗すると締め出されます)。
対応するモデル・プロバイダーと設定ファイル
この節では、どのモデルを使えるかと、設定ファイル config.yaml に何が書けるかが、取得した見本を数えた結果で分かります。
モデルは、クラウドの各社・ルーター・ローカルのサーバーから選べます。公式ドキュメント「Providers」には、Nous Portal・OpenAI Codex・Anthropic・OpenRouter・Fireworks AI・Google(Gemini)・AWS Bedrock・NVIDIA・Hugging Face・DeepSeek・Ollama Cloud などが並び、ローカルでは Ollama・vLLM・SGLang・llama.cpp・LM Studio が挙げられています。
リポジトリにある設定ファイルの見本(cli-config.yaml.example)を自作のスクリプトで読み、最上位の項目と、プロバイダーの説明に並ぶ ID を数えました。
import re, sys
cfg = open(sys.argv[1], encoding="utf-8").read()
keys = re.findall(r"^([a-z_]+):", cfg, re.M)
print(len(cfg.splitlines()), "lines /", len(keys), "top-level keys")
print(", ".join(keys))
blk = cfg[cfg.find("# Inference provider selection"):cfg.find("# Local servers")]
prov = re.findall(r'#\s+"([a-z0-9\-]+)"\s+-', blk)
print(len(prov), "provider ids:", ", ".join(prov))
2451 lines / 29 top-level keys
_config_version, database, runtime, attachments, plugins, model, kanban, cron, terminal, browser, tool_loop_guardrails, compression, prompt_caching, memory, max_concurrent_sessions, group_sessions_per_user, hosted_rooms, streaming, skills, agent, gateway, platform_toolsets, stt, code_execution, delegation, display, telemetry, auth, updates
21 provider ids: auto, openrouter, nous, nous-api, anthropic, openai-codex, gemini, zai, kimi-coding, minimax, minimax-cn, huggingface, nvidia, xiaomi, arcee, ollama-cloud, deepinfra, kilocode, ai-gateway, azure-foundry, lmstudio
見本は2,451行あり、最上位の項目は29個でした。プロバイダーの説明には21個の ID が並び、そのほかに OpenAI 互換の API を持つサーバーを指定する custom があります(ollama・vllm・llamacpp は custom の別名と書かれています)。
手元の Ollama などをつなぐ場合の書き方は、公式ドキュメントの例のとおりです。
# ~/.hermes/config.yaml
model:
provider: custom
base_url: http://localhost:8000/v1
default: モデルのID
# context_length: 65536 # 自動判定が違うときだけ
ローカルのモデルは、文脈長を 64,000 トークン以上にして起動します。公式の例は llama.cpp なら --ctx-size 65536、Ollama なら -c 65536 で、Ollama は既定の文脈長が小さいことが多いため、サーバー側で OLLAMA_CONTEXT_LENGTH を上げる場合があると書かれています。Ollama の使い方は関連記事「Ollamaの使い方|ローカルLLMのコマンド一覧とAPIの呼び方」で扱っています。
スキルの仕組み(SKILL.md)と中身を数えた結果
この節では、Hermes Agent のスキルが何で、どこに置かれ、同梱のスキルがいくつあるのかが分かります。
公式ドキュメントはスキルを「必要なときにエージェントが読み込む、手順の文書」と説明しています。1つのスキルはフォルダー1つで、YAML の frontmatter(name・description・version など)と Markdown の手順を書いた SKILL.md が中心です。形式は agentskills.io のオープンな規格と互換で、置き場所は ~/.hermes/skills/ です。
スキルの読み込みは3段階に分かれています。
- 0一覧だけ読む(skills_list)名前・説明・カテゴリ。公式の目安は約3,000トークン
- 1使うスキルの本文を読む(skill_view)要るとき初めて SKILL.md の全文を読む
- 2付属のファイルを読む(skill_view と path)長い資料はスキルのフォルダーの別ファイルに分けて置く
エージェント自身がスキルを作る・直す・消すときは skill_manage というツールを使います。公式ドキュメントによると、手間のかかる作業の進め方が分かったときに、その手順をスキルとして保存して次に使います。
同梱のスキルを数えた結果
取得したリポジトリの skills/(最初から入るスキル)と optional-skills/(追加で入れられるスキル)の SKILL.md を数えました。
| カテゴリ(同梱) | 数 | 含まれるスキルの例 |
|---|---|---|
| creative | 9 | 文章・画像などの制作まわり |
| productivity | 9 | pdf・microsoft-office・google-workspace・meeting-action-items |
| software-development | 8 | github・systematic-debugging・test-driven-development・codebase-inspection |
| apple | 4 | macOS 向け(platforms が macos だけ) |
| autonomous-ai-agents | 4 | ほかのエージェントとの連携 |
| research | 3 | 調べものの手順 |
| email・devops・media など | 7 | 6カテゴリに1〜2個ずつ |
frontmatter の項目は、44個すべてに name・description・version・author・license・platforms がありました。name とフォルダー名は44個とも一致し、description は最短44字・最長60字(英語)でした。platforms は38個が linux・macos・windows の3つで、4個が macos だけです。
読み込みの3段階がどれだけ文脈を節約するかを、設定ファイルの見本のコメントにある「約2.75文字で1トークン」という目安で試算しました。
| 読むもの | 文字数(44個の合計) | トークンの目安 |
|---|---|---|
| 名前と description だけ | 3,000 | 約1,091 |
| SKILL.md の全文 | 454,531 | 約165,284 |
| 割合 | 0.7% | — |
全部を最初から読み込むと、文脈長 64,000 トークンのモデルでは入りきりません。一覧だけを先に読み、使うものだけ全文を読む作りだから、たくさんのスキルを持てることが数字で分かります(公式の「約3,000トークン」にはカテゴリなどの情報も入るため、この試算より大きくなります)。
自分のスキルを書いて形を確かめる
同梱のスキルと同じ形で SKILL.md を書き、形が崩れていないかを点検する小さなスクリプトを作りました。必須の項目は、同梱の44個がそろえていた6項目にしています(公式が必須と定めた一覧ではありません)。
---
name: weekly-report
description: "Summarize this week's git commits into a short report."
version: 0.1.0
author: sample
license: MIT
platforms: [linux, macos, windows]
---
# Weekly Report
## When to Use
- User asks for a summary of this week's commits
## Steps
1. Run `git log --since="1 week ago" --oneline`
2. Group commits by directory
3. Write 5 bullet points
import sys, re, pathlib, yaml
REQ = ["name", "description", "version", "author", "license", "platforms"]
for p in sorted(pathlib.Path(sys.argv[1]).glob("*/SKILL.md")):
text = p.read_text(encoding="utf-8")
m = re.match(r"---\n(.*?)\n---", text, re.S)
fm = yaml.safe_load(m.group(1)) if m else {}
errs = [f"missing {k}" for k in REQ if k not in fm]
if fm.get("name") != p.parent.name:
errs.append(f"name '{fm.get('name')}' != folder '{p.parent.name}'")
if len(str(fm.get("description", ""))) > 60:
errs.append("description > 60 chars")
print(p.parent.name, "OK" if not errs else "NG: " + "; ".join(errs))
Bad_Name NG: missing description; missing version; missing author; missing license; missing platforms; name 'bad-name' != folder 'Bad_Name'
weekly-report OK
わざと崩した見本(Bad_Name)は、項目の不足とフォルダー名の食い違いで止まりました。同じスクリプトを同梱の software-development の8個にかけると、8個とも OK でした。Claude Code のスキルと書き方が近いので、関連記事「Claude Code Skillsの作り方|SKILL.md雛形と項目一覧」の雛形も参考になります。Claude Code 向けのスキル集を扱った「Superpowersとは|Claude Codeのスキル集の入れ方・使い方と中身」とも、SKILL.md の考え方は共通です。
Skills Hub からスキルを入れる
公式ドキュメントによると、オンラインの登録先(Skills Hub)のスキルを、次のコマンドで探して入れられます。
hermes skills browse # 一覧を見る
hermes skills search kubernetes # 探す
hermes skills inspect openai/skills/k8s # 入れる前に中身を見る
hermes skills install openai/skills/k8s # 入れる
hermes skills uninstall k8s # 外す
Hub から入れるスキルは、データの持ち出しやプロンプトインジェクションなどの危険がないか検査されると書かれています。それでもスキルは「エージェントへの指示書」なので、入れる前に inspect で中身を読みます。
メモリーとセッション検索の仕組み
この節では、Hermes Agent が会話をまたいで何を覚え、どこに保存しているのかが分かります。
覚えたことは、手元のファイルとデータベースに保存されます。公式ドキュメント「Memory」の記載をまとめます。
| 保存するもの | 中身 | 場所・上限 |
|---|---|---|
| MEMORY.md | エージェントのメモ(環境のこと・決まりごと・分かったこと) | ~/.hermes/memories/・2,200文字(約800トークン) |
| USER.md | 利用者のこと(好み・話し方・期待すること) | 同じ場所・1,375文字(約500トークン) |
| 会話の履歴 | CLI とチャットアプリのすべてのセッション | ~/.hermes/state.db(SQLite の FTS5 で全文検索) |
| スキル | 手順として保存したもの | ~/.hermes/skills/ |
MEMORY.md と USER.md は、セッションの始めに読み込まれ、その会話のあいだは固定された内容としてシステムプロンプトに入ります。取得した設定ファイルの見本では、memory.nudge_interval: 10(10回のやりとりごとに、覚えることがないか考えさせる)と、skills.creation_nudge_interval: 15(ツールを15回使うごとに、スキルにできないか考えさせる)が既定でした。これが README の言う「学習のループ」の正体です。
ファイルは人が開いて読めるので、覚えてほしくないことが書かれていたら消せます。外部のメモリーのサービスをつなぐ方法もありますが、公式ドキュメントによると、それは組み込みのメモリーと並んで動くもので、置き換えるものではありません。
使う前に確かめること(権限・承認・ログイン)
この節では、Hermes Agent を自分の PC や会社の環境で動かす前に、読んでおく設定と決まりが分かります。
Hermes Agent は、端末のコマンドを実行し、ファイルを読み書きし、ブラウザを操作できるソフトです。MIT ライセンスで公開されている第三者のソフトなので、使う前に中身と、与える権限を自分で確かめます。この記事は Hermes Agent の安全性を保証するものではありません。業務のコードや個人情報・機密情報を扱う場合は、Nous Research と、使うモデルの提供元の最新の規約、所属先の決まりを先に確かめます。
- 1危ないコマンドの承認のモードを決めたか公式によると approvals.mode は smart(既定。補助のモデルが危険度を判断)・manual(危ないコマンドは毎回たずねる)など。迷ったら manual
- 2コマンドを動かす場所を決めたか公式は本番の運用では terminal.backend を docker にすることと、root で動かさないことを勧めている
- 3ほかのツールのログインを借りる設定を見たか見本では auth.adopt_external_logins が true。Codex CLI と Claude Code のログインを借りる。別にしたいなら false
- 4チャットアプリから使える人を絞ったか公式は許可する利用者の一覧を設定し、全員を許可する設定を本番で使わないよう書いている
- 5入れるスキル・プラグインの中身を読んだかhermes skills inspect で先に読む。SKILL.md は指示書なので、知らないものは入れない
- 6送信の設定を見たか見本では telemetry.shared_metrics の enabled と send がどちらも false
承認の画面は、取得した日本語の翻訳ファイル(locales/ja.yaml)に次の文言で入っていました。危ないコマンドを動かす前に、今回だけ許すか、そのセッション中は許すか、断るかを選ぶ作りです。
approval:
dangerous_header: "⚠️ 危険なコマンド: {description}"
choose_long: " [o]今回のみ | [s]セッション中 | [a]常に許可 | [d]拒否"
allowed_once: " ✓ 今回のみ許可"
blocklist_message: "このコマンドは無条件ブロックリストに含まれており、承認できません。"
公式ドキュメントによると、承認のしくみの下には「どのモードでも止める一覧(ブロックリスト)」があり、承認を飛ばすモードでもそれは動きます。この記事では、承認やブロックを外す設定は扱いません。エージェントにどこまで任せるかの考え方は、関連記事「ハーネスとは|AIエージェントの仕組みとハーネスエンジニアリング入門」で扱っています。
日本語で使うには(画面の言語と会話)
この節では、Hermes Agent を日本語で使うときに、何が日本語になり、何がモデルしだいなのかが分かります。
会話の言葉は、選んだ AI モデルが日本語を扱えるかで決まります。日本語で頼めば日本語で返すモデルが多いですが、得手不得手はモデルごとに違います。公式ドキュメントは英語で書かれています。
画面の決まった文言(承認の確認・エラーの案内など)には翻訳ファイルがあります。取得したリポジトリの locales/ を数えた結果です。
en keys 3564 ja keys 3564 ja∩en 3564 coverage 100.0%
languages 17 ['af', 'ar', 'de', 'en', 'es', 'fr', 'ga', 'hu', 'it', 'ja', 'ko', 'pt', 'ru', 'tr', 'uk', 'zh', 'zh-hant']
英語の 3,564 個のキーすべてに日本語の訳がありました。言語の選び方は、ソースの agent/i18n.py の説明によると「明示した指定 → 環境変数 HERMES_LANGUAGE → 設定の display.language → 英語」の順です。訳がないキーは英語に戻ります。
日本語にならないと感じたとき
分けて考えると、どちらを直せばよいかが分かる
Hermes Agentのよくあるつまずき
この節では、入れるときと使い始めに起きやすいことと、公式の記載にある確かめ方が分かります。
| 症状 | 原因 | 確かめ方・直し方 |
|---|---|---|
入れたのに hermes: command not found | シェルが PATH の追加を読み込んでいない | source ~/.bashrc(zsh は ~/.zshrc)か、端末を開き直す |
| 起動時にモデルが断られる | 文脈長が 64,000 トークン未満 | 文脈長の大きいモデルを選ぶ。ローカルは --ctx-size 65536 などで起動し直す |
| Ollama のモデルで途中から話がかみ合わない | Ollama の既定の文脈長が小さい | サーバー側で文脈長を上げる(公式の例は OLLAMA_CONTEXT_LENGTH) |
| Intel の Mac で入らない | macOS のインストーラーは Apple Silicon のみ | 公式ドキュメント Installation の対応環境を確かめる |
| インストールの途中で止まる | ブラウザなどの取得に失敗した | ~/.hermes/logs/install.log を読む。表示された再実行のコマンドを使う |
| セキュリティソフトが警告を出す | 同梱の道具(uv など)が検出された | README の手順で配布元の署名を確かめ、所属先の管理者とソフトの提供元の案内に従う |
| チャットアプリから返事がない | ゲートウェイが動いていない、またはペアリング待ち | hermes gateway start の状態と、CLI でのペアリングの承認を確かめる |
| 原因が分からない | 設定やつながりの問題 | hermes doctor を実行し、表示に沿って直す |
うまく動かないときに、データの置き場所(~/.hermes)を消して直そうとしないことも公式ドキュメントに書かれています。メモリー・スキル・会話の履歴が消えるためです。
リポジトリの中身(ファイル構成を数えた結果)
この節では、Hermes Agent のソースがどんなまとまりでできているのかが、取得したリポジトリを数えた結果で分かります。
main ブランチで Git に追跡されているファイルは 26,130 個でした。フォルダーごとの内訳の上位です。
| フォルダー | ファイル数 | 中身(README・ファイル名から) |
|---|---|---|
| tests | 8,691 | テスト |
| apps | 5,049 | デスクトップアプリなど |
| plugin-catalog | 2,381 | プラグインの一覧 |
| hermes_cli | 889 | hermes コマンド |
| optional-skills | 819 | 追加できるスキル(141個) |
| agent | 460 | エージェントの本体の処理 |
| tools | 414 | ツール(直下の .py は324個) |
| gateway | 409 | チャットアプリとのゲートウェイ |
| skills | 308 | 同梱のスキル(44個) |
拡張子では .py が 11,962 個、.ts と .tsx が合わせて 5,619 個でした。pyproject.toml には、直接の依存をすべて「==」で版を固定している理由が書かれています(2026年5月に PyPI で依存パッケージの不正な版が公開された件を受けて、範囲指定をやめた、という説明です)。プロバイダーごとに要るライブラリは、選んだときだけ入れる作りです。
データの置き場所(~/.hermes/)の中には、設定(config.yaml)、秘密の値(.env・auth.json)、メモリー、スキル、会話のデータベースがまとまります。バックアップや移行のときは、このフォルダーを単位に考えます。
判断表:Hermes Agentが合う使い方
この節では、やりたいことに対して Hermes Agent をどう使うか、何を確かめておくかが分かります。
ほかのエージェントとの優劣ではなく、Hermes Agent の作りから見た向き・不向きを並べます。
| やりたいこと | Hermes Agent での形 | 先に確かめること |
|---|---|---|
| スマホのチャットアプリから PC やサーバーに作業を頼みたい | ゲートウェイを動かし、Telegram などから送る | 使える人の一覧・ペアリング・動かす場所 |
| 毎朝のまとめを自動で届けたい | 組み込みの cron に自然な文章で登録 | 動かしっぱなしにするマシン・モデルの料金 |
| 手元の PC だけで完結させたい | Ollama・llama.cpp などのローカルモデルを custom でつなぐ | 文脈長 64,000 トークン以上を動かせる GPU とメモリー |
| API キーを何本も管理したくない | Nous Portal(hermes setup --portal) | 月額と枠・クレジットの減り方 |
| 知らないコードやコマンドを試したい | terminal.backend を docker などにする | コンテナに渡すフォルダー・承認のモード |
| 同じ手順を何度も頼む | スキルとして保存させる・自分で SKILL.md を書く | スキルの中身を読む習慣 |
OpenClaw・Claude Code・Codex CLI・Cursor から移る場合は、README によると hermes setup の途中で設定・メモリー・スキルを取り込むかをたずねられます。あとから取り込むときは agent-importers プラグインを入れて hermes import-agent openclaw --dry-run のように先に内容を見てから実行します。API キーは --migrate-secrets を付けたときだけ取り込まれます。
よくある質問
この節では、Hermes Agent について調べる人が気にすることへの短い答えが分かります。
Q. Hermes Agent は無料ですか。
本体は MIT ライセンスで無料です。AI モデルの利用料は別で、各社の API の料金か Nous Portal の月額・クレジットがかかります。ローカルモデルなら API の料金はかかりませんが、動かすための PC が要ります。
Q. Hermes Agent はどこの会社のものですか。
Nous Research, Inc. です。公式サイトは hermes-agent.nousresearch.com、ソースは GitHub の NousResearch/hermes-agent で公開されています。
Q. Windows で使えますか。
使えます。README は WSL なしで CLI・ゲートウェイ・TUI・ツールが動くとしています。PowerShell の iex (irm https://hermes-agent.nousresearch.com/install.ps1) か、デスクトップアプリで入れます。WSL2 の中で Linux 用のコマンドを使う方法もあります。
Q. GPU は要りますか。
クラウドのモデル(各社の API や Nous Portal)を使うなら、Hermes Agent 自体に GPU は要りません。README は月 5 ドルの VPS でも動かせると書いています。手元でモデルを動かす場合は、文脈長 64,000 トークン以上を扱えるだけの GPU とメモリーが要ります。
Q. Hermes 4 などの Hermes モデルと同じものですか。
違います。Hermes 4 などは Nous Research の言語モデルで、Hermes Agent はモデルを動かして作業させるソフトです。Hermes Agent では Hermes 以外のモデルも選べます。
Q. 読み方は「ハーメス」と「ヘルメス」のどちらですか。
公式の文書に読み方の記載は見つかりませんでした。日本語ではどちらも使われていて、どちらで検索しても同じ製品の情報にたどり着きます。
Q. 日本語で話しかけられますか。
話しかけられます。返事の言葉と質は選んだモデルによります。画面の決まった文言には日本語の翻訳ファイルがあり、取得した版では英語のキーすべてに訳がありました。
Q. 会話の内容はどこに保存されますか。
手元の ~/.hermes/state.db(SQLite)です。メモリーは ~/.hermes/memories/ の MEMORY.md と USER.md に入ります。ただし、会話の内容は使うモデルの提供元に送られるので、その扱いは提供元の規約で確かめます。
Q. 会社の業務で使ってよいですか。
ライセンスの条件と、扱う情報の決まりは、Nous Research とモデルの提供元の最新の規約、所属先の決まりで確かめます。この記事では可否を判断しません。
Q. 消したいときはどうしますか。hermes uninstall --dry-run で何が消えるかを見てから hermes uninstall を実行します。データも消すなら --full です。先に hermes backup を取ることが公式ドキュメントで勧められています。
まとめ
この節では、記事の要点が5つに分かります。
- Hermes Agent は Nous Research の MIT ライセンスのオープンソースの AI エージェントで、使いながらスキルとメモリーをためる「学習のループ」が特徴です。
- 本体は無料、モデルの料金は別です。各社の API キー・Nous Portal(Free・月 $20・$100・$200)・ローカルモデルから選び、文脈長 64,000 トークン以上が条件です。
- Linux・macOS・WSL2 は
install.sh、Windows はinstall.ps1かデスクトップアプリで入り、hermes model→hermes --tuiで使い始めます。 - 取得した版では、同梱スキル44個(追加できるもの141個)、設定の最上位の項目29個、日本語の画面文言 3,564 キーを数えました。スキルは一覧だけ先に読む作りで、全文の約0.7%で済みます。
- 端末とファイルを扱うソフトなので、承認のモード・動かす場所・ほかのツールのログインを借りる設定・使える人の一覧を、使う前に確かめます。
参考・出典
この節では、記事を書くときに確かめた公式の情報源が分かります(確認日 2026年11月16日)。
- Hermes Agent 公式サイト https://hermes-agent.nousresearch.com/
- NousResearch/hermes-agent(README・LICENSE・pyproject.toml・cli-config.yaml.example・scripts/install.sh・locales・agent/i18n.py。コミット 9431f2e) https://github.com/NousResearch/hermes-agent
- Hermes Agent のリリース一覧 https://github.com/NousResearch/hermes-agent/releases
- 公式ドキュメント「Installation」 https://hermes-agent.nousresearch.com/docs/getting-started/installation
- 公式ドキュメント「Quickstart」 https://hermes-agent.nousresearch.com/docs/getting-started/quickstart
- 公式ドキュメント「Updating & Uninstalling」 https://hermes-agent.nousresearch.com/docs/getting-started/updating
- 公式ドキュメント「Providers」 https://hermes-agent.nousresearch.com/docs/integrations/providers
- 公式ドキュメント「Tools & Toolsets」 https://hermes-agent.nousresearch.com/docs/user-guide/features/tools
- 公式ドキュメント「Skills System」 https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
- 公式ドキュメント「Memory」 https://hermes-agent.nousresearch.com/docs/user-guide/features/memory
- 公式ドキュメント「Security」 https://hermes-agent.nousresearch.com/docs/user-guide/security
- Nous Portal https://portal.nousresearch.com
- Nous Research 公式サイト https://nousresearch.com/
- Nous Research 公式フォーラム「Nous Research presents Hermes 4」 https://forum.nousresearch.com/t/nous-research-presents-hermes-4-our-latest-line-of-open-source-models/270
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Hermes Agentとは|入れ方・使い方・料金と同梱スキル44個」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。