Hermes Agent クイックスタート

このガイドは、ゼロの状態から実用に耐える Hermes 環境までを一気に立ち上げるためのものです。インストールし、プロバイダーを選び、チャットが動くことを確かめ、うまくいかないときに何をすればいいかまで押さえます。

動画で見たい方へ

Onchain AI Garage が、インストール・セットアップ・基本コマンドをひと通りたどるマスタークラス動画を公開しています。動画を見ながら進めたい方には、このページの良い相棒になります。ほかの動画は Hermes Agent Tutorials & Use Cases のプレイリストにまとまっています。

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

こんな方に

• まったくの初めてで、動く状態までの最短ルートを知りたい
• プロバイダーを乗り換えるところで、設定ミスに時間を取られたくない
• チーム用・ボット用・常時稼働の用途で Hermes を用意したい
• 「入ったはいいが、何も起きない」状態にうんざりしている

いちばん速い進め方

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

目安: Hermes が普通のチャットすらこなせない状態なら、まだ機能を足さないでください。まずきれいな会話をひとつ成立させ、そのうえでゲートウェイ、cron、スキル、音声、ルーティングを重ねていきます。

1. Hermes Agent をインストールする

macOS / Windows で Hermes Desktop インストーラーを使う（推奨）

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

Hermes Desktop を使わない場合

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

Linux / macOS / WSL2 / Android（Termux）

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 — 再利用できる手順を探して入れる
• Cron — ボットや 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 はまだ未対応です。

音声モード

# From the Hermes install directory (the curl installer placed it at
# ~/.hermes/hermes-agent on Linux/macOS or %LOCALAPPDATA%\hermes\hermes-agent on Windows):
cd ~/.hermes/hermes-agent
uv pip install --python ./venv/bin/python -e ".[voice]"
# Includes faster-whisper for free local speech-to-text

そのうえで CLI から /voice on を実行します。録音は Ctrl+B です。音声モード を参照してください。

スキル

スキルとは、特定の作業のやり方を Hermes に教える、必要なときだけ読み込まれる手順書です。Kubernetes へのデプロイ、GitHub の PR 作成、モデルのファインチューニング、GIF 検索といった具合です。実体は SKILL.md というファイルで、名前・説明・手順が書かれています。エージェントは短い説明だけを常に把握しておき、実際に必要になったときにはじめて全文を読み込むので、スキルを増やしても毎回のリクエストが重くなることはありません。

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 && uv pip install -e ".[acp]" を実行してください。）

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つだけ）移行できます。一から組み直す必要はありません