Hermes Agent クイックスタート

このページの Python 依存に関するコマンドは、 PM で準備したソースのチェックアウトを前提にしています。 依存を変えたら、チェックアウトをもう一度有効にしてから Hermes を再起動してください。

この案内では、何も無い状態から、実際に使い続けられる Hermes の環境までを作ります。インストールし、プロバイダーを選び、会話がちゃんと動くことを確かめ、うまくいかないときに何をすればよいかまで分かる形にします。

動画で見たい方へ

Onchain AI Garage が、インストール・初期設定・基本のコマンドをひととおり見せるマスタークラス動画を作っています。文章を追うより動画で一緒に手を動かしたい方には、このページのよい相棒になります。もっと見たい場合は Hermes Agent Tutorials & Use Cases の再生リストをどうぞ。

YouTube: https://www.youtube-nocookie.com/embed/R3YOGfTBcQg

こんな方に向いています

• まったくの初めてで、動く状態までの最短の道を知りたい
• プロバイダーを乗り換えるところで、設定の間違いに時間を取られたくない
• チームやボット、動かしっぱなしの仕組みのために Hermes を用意したい
• 「入ったけれど何も起きない」に疲れている

いちばん速い道

自分の目的に合う行を選んでください。

目安: Hermes が普通の会話をこなせないうちは、機能を足さないでください。まずきれいな会話を 1 本通してから、ゲートウェイ、定期実行、スキル、音声、振り分けを重ねていきます。

1. Hermes Agent を入れる

macOS か Windows で Hermes Desktop のインストーラーを使う（おすすめ）

コマンドラインとデスクトップの両方を手軽に入れるには、公式サイトから Hermes Desktop のインストーラーを入手 して実行してください。

Hermes Desktop を使わない場合:

Hermes Desktop なしでコマンドラインだけを入れるには、次を実行します。

aarch64 の Android 端末では、別の Termux APT の案内を使ってください。

Linux / macOS / WSL2

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

Windows（そのまま）

powershell で実行します。

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

終わったら、シェルを読み込み直します。

source ~/.bashrc   # or source ~/.zshrc

インストールの細かい選択肢、必要なもの、うまくいかないときの対処は インストールの案内 にあります。

2. プロバイダーを選ぶ

ここが最初の設定でいちばん大事なところです。hermes model を使うと、対話しながら選べます。

hermes model

無難な選び方は次のとおりです。

初めての方のほとんどは、プロバイダーを選んだら、変える理由がはっきりしない限り既定のままで大丈夫です。環境変数と設定手順を載せたプロバイダーの全一覧は プロバイダー のページにあります。

設定はどこに保存されるのか

Hermes は、秘密の情報と普通の設定を分けて保存します。

• 秘密の情報とトークン → ~/.hermes/.env
• 秘密ではない設定 → ~/.hermes/config.yaml

正しい場所に値を書くいちばん簡単な方法は、CLI を使うことです。

hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...

それぞれの値が、自動で正しいファイルへ振り分けられます。

3. 最初の会話をする

hermes            # classic CLI
hermes --tui      # modern TUI (recommended)

使っているモデル、使えるツール、スキルが並んだ開始画面が出ます。うまくいったかどうかを確かめやすい、具体的な頼み方をしてみてください。

Summarize this repo in 5 bullets and tell me what the main entrypoint is.

Check my current directory and tell me what looks like the main project file.

Help me set up a clean GitHub PR workflow for this codebase.

うまくいっているときの様子:

• 開始画面に、選んだモデルとプロバイダーが出ている
• Hermes がエラーを出さずに返事をする
• 必要ならツールを使える（端末、ファイルの読み取り、Web 検索）
• 会話が 1 往復で終わらず、そのまま続く

ここまで動けば、いちばん難しいところは越えています。

4. セッションが動くか確かめる

次に進む前に、会話の再開が効くことを確かめてください。

hermes --continue    # Resume the most recent session
hermes -c            # Short form

さっきまでの会話に戻れるはずです。戻れない場合は、同じプロファイルにいるか、会話が実際に保存されているかを確かめてください。ここは、あとで複数の構成や複数の端末を行き来するときに効いてきます。

5. 主な機能を試す

端末を使わせる

❯ What's my disk usage? Show the top 5 largest directories.

エージェントが代わりに端末のコマンドを実行し、結果を見せてくれます。

スラッシュコマンド

/ と打つと、コマンドの候補が一覧で出ます。

複数行の入力

Alt+Enter、Ctrl+J、Shift+Enter のいずれかで改行できます。Shift+Enter は、それを別の入力として送る端末でだけ使えます（既定で使えるのは Kitty / foot / WezTerm / Ghostty。iTerm2 / Alacritty / VS Code の端末は Kitty のキーボードプロトコルを有効にすれば使えます）。Alt+Enter と Ctrl+J はどの端末でも使えます。

エージェントを止める

待たされていると感じたら、新しいメッセージを打って Enter を押してください。今の作業を中断して、新しい指示のほうへ切り替わります。Ctrl+C でも止まります。

6. 次の層を足す

基本の会話が動いてからにしてください。必要なものだけを選びます。

ボットや、みんなで使う相談相手

hermes gateway setup    # Interactive platform configuration

Telegram、Discord、Slack、WhatsApp、Signal、メール、Home Assistant（プラグイン）、Microsoft Teams につなげます。

自動化とツール

• hermes tools — 入口ごとに、どのツールを使わせるかを調整します
• hermes skills — 繰り返し使える手順を探して入れます
• 定期実行 — ボットや CLI の構成が安定してから

隔離した端末

安全のために、エージェントを Docker のコンテナや別のサーバーの上で動かせます。

hermes config set terminal.backend docker    # Docker isolation
hermes config set terminal.backend ssh       # Remote server

Docker で隔離する場合は、外向き通信に認証情報を差し込む中継も有効にできます。こうすると、隔離した環境から本物の API キーは見えず、見えるのは手元の TLS を仲介する常駐プロセスの後ろでしか通らない、意味を持たない代替のトークンだけになります。外向き通信の中継 を参照してください。用意は hermes egress setup && hermes egress start で、hermes setup terminal でも Docker を使う人にはここが案内されます。Modal、SSH、Daytona、Singularity にはまだ対応していません。

音声モード

hermes tools を実行して、音声のプロバイダーを設定します。そのあと CLI で /voice on と打って有効にし、Ctrl+B を押すと録音できます。対応している依存が足りなければ PM が 用意します。依存が変わると再起動が必要になることがあります。ローカルの Faster-Whisper は、 すべてのアーキテクチャで使えるわけではありません。音声モード を参照してください。

スキル

スキルは、必要になったときだけ読み込まれる手順書です。Kubernetes への配備、GitHub の PR の作成、モデルの追加学習、GIF 探しなど、特定の作業のやり方を Hermes に教えます。中身は、名前と説明と手順を書いた SKILL.md ファイル 1 つです。エージェントは短い説明だけを常に見ていて、作業が本当にそれを必要としたときにはじめて全文を読み込むので、スキルを増やしても毎回の要求が膨らむことはありません。

Hermes には、あらかじめ選ばれたスキルが ~/.hermes/skills/ に入った状態で届きます。Skills Hub からさらに足すことも、自分で書くこともできます。

ハブで探して入れる:

hermes skills browse                      # list everything available
hermes skills search kubernetes           # find skills by keyword
hermes skills install openai/skills/k8s   # install one (runs a security scan first)

install に渡すのは、ハブでの source/path という短い名前です。openai/skills/k8s は、OpenAI の一覧にある k8s というスキルという意味です。正確な名前は hermes skills browse で確認できます。

スキルを使う — 入れたスキルは、自動でスラッシュコマンドになります。

/k8s deploy the staging manifest          # run the skill with a request
/k8s                                       # load it and let Hermes ask what you need

これは CLI でも、つないだメッセージのサービスでも同じように使えます。最初に全部入れておく必要はありません。普通に会話しているだけでも、作業に合うスキルがあれば、エージェントが同梱のものから自分で選びます。

自分で書く方法、外部のスキル置き場、ハブの提供元の一覧は スキルの仕組み にあります。

MCP サーバー

# Add to ~/.hermes/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

エディターとの連携（ACP）

ACP への対応は標準の [all] の追加分に含まれているので、curl のインストーラーを使っていればすでに入っています。次を実行するだけです。

hermes acp

（[all] なしで入れた場合は、先に cd ~/.hermes/hermes-agent && python -c "import pm; pm.sync_venv(['acp'], explicit=True)" を実行してください。）

ACP でのエディター連携 を参照してください。

よくあるつまずき

時間をいちばん食う問題は次のとおりです。

立て直しの道具箱

何かおかしいと感じたら、この順に試してください。

1. hermes doctor
2. hermes model
3. hermes setup
4. hermes sessions list
5. hermes --continue
6. hermes gateway status

この順番なら、「なんだか壊れている」状態から、分かっている状態まで早く戻れます。

早見表

次の一歩

• CLI の案内 — 端末での使い方を身につける
• 設定 — 自分に合わせて調整する
• メッセージのゲートウェイ — Telegram、Discord、Slack、WhatsApp、Signal、メール、Home Assistant、Teams などにつなぐ
• ツールとツール群 — 何ができるのかを見て回る
• AI プロバイダー — プロバイダーの全一覧と設定の詳細
• スキルの仕組み — 繰り返し使える手順と知識
• コツと勘どころ — 使い込んだ人向けのコツ
• 別の端末へ移る — hermes backup で環境をまるごと引っ越せます（プロファイル 1 つだけ も可）。一から作り直す必要はありません