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` サーバーが使用するポートを変更します。スマートフォン、ノートPC、その他ネットワーク上のデバイスからAPIサーバーに接続したい場合は、次のように起動します `-H 0.0.0.0`.
アプリによっては、個別リクエストごとに生成設定を上書きする場合があります。さらに高度な実行時設定については、メインの [APIチューニング](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.