> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/jp/meru/install/mac.md).

# MacOSにUnslothをインストールする

macOSにUnsloth Desktop、Unsloth Studio、またはUnsloth Coreをインストールします。

インストールするには **Unsloth Desktop** MacでMLXまたはGGUFモデルを実行・学習するには、以下の手順に従ってください。

{% stepper %}
{% step %}

### ダウンロード

<a href="https://unsloth.ai/download/mac" class="button secondary" data-icon="apple">Mac用のUnslothをダウンロード</a>
{% endstep %}

{% step %}

### インストール

1. Unsloth インストーラーを開き（`.dmg` ファイル）
2. Unslothを次へドラッグ **アプリケーション**
3. アプリを起動し、インストールが完了するまで待ちます
   {% endstep %}

{% step %}

### モデルを選択

上部の「モデルを選択」ドロップダウンまたは「Model hub」タブを開き、デバイスに合うモデルと量子化を選んでからダウンロードします。完了したら、すぐにチャットを開始できます。セットアップは不要です。

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FNCEVgKLJI0goPqjgcg9B%2Fmodel%20hub%20models.png?alt=media&amp;token=533b5e3c-a901-4b33-963e-4a703cc9d5a6" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### これで Unsloth の準備ができました

チャットを開始するには、メッセージを入力して Enter キーを押します。

* **ツールを接続：** [Claude Code](/docs/jp/ji-ben/claude-code.md), [Codex](/docs/jp/ji-ben/codex.md)、Web 検索、 [MCP](/docs/jp/ji-ben/mcp.md) など
* **モデルを学習：** テキスト、拡散、埋め込みなどをファインチューニング
* **メディアを生成：** 画像、動画、TTS をローカルで作成・学習

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FpAGvwjGD0iVMZKBoyu7m%2Fgreeennn.png?alt=media&amp;token=d17a5528-8375-444c-9aff-f9e9f7903bcd" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Unsloth Studio を手動でインストール

以下のコマンドでインストールされるのは **Unsloth Studio**、ブラウザベースのWeb UIです。Unsloth DesktopやコードベースのUnsloth Coreパッケージはインストールされません。

#### Unsloth Studioをインストール

```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```

同じコマンドを使って **更新する**.

### 起動

再度Unslothを起動するたびに：

```bash
unsloth studio -H 0.0.0.0 -p 8888
```

Unsloth Studio の詳細なインストール手順と要件については、 [ガイドを見る](/docs/jp/xin-zhe/studio/install.md).

## アンインストール

### デスクトップ版のアンインストール

1. Unslothが実行中なら終了します
2. 開く **Finder**
3. 移動 **アプリケーション**
4. Unslothを見つける
5. 右クリック → **ゴミ箱に入れる**

#### Unsloth Studioの手動アンインストール

Unsloth Studioを完全に削除する推奨方法は、お使いのOS用のアンインストールスクリプトです。実行中のサーバーを停止し、アプリ、CLIコマンド、ランチャーデータ、ショートカット、およびプラットフォーム固有のエントリ（macOS `.app` バンドル + Launch Services; Windowsのスタートメニュー + レジストリ + PATH）：

```shellscript
curl -fsSL https://raw.githubusercontent.com/unslothai/unsloth/main/scripts/uninstall.sh | sh
```

特定の部分だけを削除したい場合は：

**1. アプリのみ削除** （履歴、チャット、チェックポイント、エクスポートはそのまま残ります）：

* `rm -rf ~/.unsloth/studio/unsloth_studio`

**2. Unslothを完全に削除** （他のUnslothツールはそのまま残ります）：

* &#x20;`rm -rf ~/.unsloth/studio`

**3. Unsloth関連のすべてを削除：**

* `rm -rf ~/.unsloth`

{% hint style="warning" %}
注意：ステップ3では、履歴、チャット、モデルのチェックポイント、エクスポートのすべてが削除されます。これは元に戻せません。
{% endhint %}

**4. ショートカットとシンボリックリンクを削除：**

```shellscript
rm -rf ~/Applications/Unsloth\ Studio.app ~/Desktop/Unsloth\ Studio
```

**5. CLIコマンドを削除：**

* `rm -f ~/.local/bin/unsloth`

{% hint style="info" %}
注意：ステップ1〜5では、ダウンロード済みのHFモデルファイルには触れません。その容量を解放したい場合は、下の「キャッシュされたHFモデルファイルの削除」を参照してください。
{% endhint %}

### **モデルファイルの削除**

古いモデルファイルは、モデル検索のゴミ箱アイコンから削除するか、Hugging Faceのキャッシュディレクトリから該当するキャッシュ済みモデルフォルダを削除して消去できます。

デフォルトのキャッシュ場所は：

```bash
~/.cache/huggingface/hub/
```

もし `HF_HUB_CACHE` または `HF_HOME` が設定されている場合は、代わりにその場所を使用してください。確認するには次を実行します：

```bash
echo ${HF_HUB_CACHE:-${HF_HOME:-${XDG_CACHE_HOME:-$HOME/.cache}/huggingface}/hub}
```

特定のモデルを削除するには、そのフォルダ（例： `models--unsloth--Llama-3.1-8B-bnb-4bit`）をキャッシュディレクトリから削除します。すべてのキャッシュ済みモデルを消去するには：

```bash
rm -rf ~/.cache/huggingface/hub/
```


---

# 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/meru/install/mac.md?ask=<question>&goal=<endgoal>
```

`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.
