> 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-chu/claude-code.md), [Codex](/docs/jp/ji-chu/codex.md)、Web 検索、 [MCP](/docs/jp/ji-chu/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 パッケージはインストールされません。

#### **ターミナル：**

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

更新するには同じコマンドを使います。

#### **Homebrew：**

{% tabs %}
{% tab title="インストール" %}

```bash
brew install --cask unsloth
```

{% endtab %}

{% tab title="更新" %}

```bash
brew upgrade --cask unsloth
```

{% endtab %}
{% endtabs %}

### 起動

Unsloth を再度起動したいときは毎回：

{% tabs %}
{% tab title="ローカル起動" %}

```bash
unsloth studio
```

{% endtab %}

{% tab title="リモートアクセス" %}

```bash
unsloth studio --secure
```

{% endtab %}
{% endtabs %}

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

## アンインストール

### Desktop のアンインストール

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