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. 次へ移動し、 **Settings** → **API**.
3. わかりやすい名前を入力し（例： `hermes-agent-macbook`).
4. *（任意）* 有効期限を設定します。
5. クリックします **Create**.
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の調整](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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
