Unsloth は、Unsloth プロバイダー、モデル、コンテキスト設定がすでに構成された別の管理対象ホームから Hermes を起動します。既存の Hermes セットアップは変更されません。
この管理対象ホームは既定では一時的です。セッションと状態を保持したい場合は、次を追加してください `--persist` 初回起動時に：
```bash
unsloth start hermes --persist
```
後で最新のセッションに戻るには、次を実行します：
```bash
unsloth start hermes --persist --continue
```
特定のセッションを再開するには、次を使用します `--resume ` を使ってください。
完全な [unsloth start](/docs/jp/tong-he/unsloth-start.md) モデル選択、リモート接続、詳細オプションのリファレンス。
Hermes プロバイダーを自分で管理したい場合は、下のセットアップウィザードも引き続き利用できます。
### 🔑 APIキーの作成
1. サイドバーを開き、左下の **Unsloth** アバターをクリックします。
2. 移動します **設定** → **API**.
3. わかりやすい名前を入力します（例： `hermes-agent-macbook`).
4. *（任意）* 有効期限を設定します。
5. クリック **作成**.
6. **キーはすぐにコピーしてください。** Unslothはハッシュのみを保存するため、再表示はできません。
すべてのキーは次の接頭辞で始まります： `sk-unsloth-` です。同じページからいつでもキーを無効化できます。無効化されたキーでのリクエストは `401 Unauthorized`.
### 🦥 Hermes を Unsloth API に統合
Hermes は各チャットターンを設定済みの推論プロバイダーに送り、次に接続します **OpenAI互換** エンドポイントへ。プロバイダーはインストール中または後からセットアップウィザードで設定できます。
**1. セットアップウィザードを開く：**
{% columns %}
{% column %}
```bash
hermes setup
```
選ぶなら **モデルとプロバイダー** を「何をしたいですか？」メニューから選んで推論エンドポイントのみを設定するか、 **フルセットアップ** を選んで、すべて（TTS、ツール、メッセージングゲートウェイ、エージェント設定）を順に設定します。
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
**2. カスタム OpenAI 互換エンドポイントを選択する** Hermes が推論プロバイダーを尋ねたときに選択します。
**3. プロンプトに入力する** Hermes の案内に従って入力します：
| プロンプト | 値 |
| ---------------------------- | -------------------------------------------------------- |
| **API ベース URL** | `http://localhost:8888/v1` *（あなたの Unsloth のポート + `/v1`)* |
| **API キー** | あなたの `sk-unsloth-…` キー |
| **検出されたモデル：… このモデルを使用しますか？** | `Y` *（Hermes は次を通じてモデルを自動検出します： `GET /v1/models`)* |
| **トークン数のコンテキスト長** | *（自動検出するには空欄のまま）* |
| **表示名** | 好きな名前で構いません。例： `unsloth-api` |
Hermes は次に対してエンドポイントを検証します： `/v1/models` そして続行前に検出されたモデルを確認します。
**4. 残りのプロンプトは既定値を受け入れる** （TTS、ツール、メッセージングゲートウェイ、エージェント設定）は後でいつでも再設定できます。Hermes はすべてを書き込みます `~/.hermes/config.yaml` と `~/.hermes/.env`.
**5. Hermes を起動する：**
```bash
hermes
```
起動バナーにはステータスバーに Unsloth のモデル名が表示されます（例： `unsloth/Qwen3.6-27B-GGUF`）、そしてプロンプトが入力待ちになります。
{% hint style="info" %}
後でモデルだけを再設定するには、次を実行します `hermes setup model`。設定ファイルを直接編集するには、 `hermes config edit` を開きます `~/.hermes/config.yaml` あなたの `$EDITOR`.
{% endhint %}
### オプション：Unsloth サーバーを調整する
`unsloth run` ローカル API サーバーを起動し、アプリが接続するためのモデルを読み込みます。起動時のサーバー動作もカスタマイズできます。
```bash
# Hermes を提供する（--disable-tools でエージェント自身のツールを通過させる）
unsloth run \\
--model unsloth/gemma-4-26B-A4B-it-GGUF \
--disable-tools \
--reasoning off \
-p 8888
```
{% hint style="warning" %}
使用 `--disable-tools` Hermes（または独自のツールを持つ外部エージェント）を動かすときに使用します。既定では Unsloth Studio はサーバー側の独自ツールを実行するため、エージェントのツール呼び出しが取り込まれてしまい、Hermes は応答するもののツールは実行されません。 `--disable-tools` パススルーに切り替え、Hermes 自身のツールが使われます。
{% endhint %}
使用 `--reasoning off` で思考をオフにするか、 `--reasoning on` で、推論に対応したモデルで思考をオンにします。
```bash
# ローカルネットワーク上に API を公開する
unsloth run \\
--model unsloth/gemma-4-26B-A4B-it-GGUF \
-H 0.0.0.0 \\
-p 8888
```
これによりサーバーは `0.0.0.0:8888`で起動し、ローカルネットワーク上の他のデバイスが接続できるようになります。 `-p` サーバーが実行するポートを変更します。ネットワーク上のスマートフォン、ノートパソコン、その他のデバイスから API サーバーに接続したい場合は、次を付けて起動します `-H 0.0.0.0`.
一部のアプリは、個別リクエストの生成設定を上書きする場合があります。より高度な実行時設定については、メインの [API tuning](https://unsloth.ai/docs/basics/api#unsloth-run-command) セクションを参照してください。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://unsloth.ai/docs/jp/tong-he/hermes-agent.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.