Unsloth は、プロバイダー、モデル、コンテキスト設定があらかじめ構成された別の管理されたホームから Hermes を起動します。既存の Hermes 設定は変更されません。
この管理されたホームは既定では一時的です。セッションと状態を保持するには、最初の起動時に `--persist` を追加してください：
```bash
unsloth start hermes --persist
```
後で最新のセッションに戻るには、次を実行します：
```bash
unsloth start hermes --persist --continue
```
特定のセッションを再開するには、代わりに `--resume ` を使用します。
モデル選択、リモート接続、高度なオプションに関する完全な [unsloth start](/docs/jp/lian-xie/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 %}
を使ってください `で llama.cpp でも使えます！` 思考をオフにするには、または `を` 推論をサポートするモデルでオンにするには、
```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 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/lian-xie/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.
