> 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/pip-install.md).
# pipとuvでUnslothをインストール
**Unsloth Desktop**, **Unsloth Studio**と **Unsloth コア** は別の方法でインストールされます。このページでは、Studio の手動インストールと、コードベースの Core パッケージを扱います。
### Unsloth Desktop
ネイティブのデスクトップアプリについては、以下のコマンドの代わりに OS 用のダウンロードを使用してください:
* :apple: [macOS 用をダウンロード](https://unsloth.ai/download/mac)
* :windows: [Windows 用をダウンロード](https://unsloth.ai/download/windows)
* :linux: [Linux 用をダウンロード](https://unsloth.ai/download/linux)
## **Unsloth Studio**
#### **MacOS、Linux、WSL:**
```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```
更新するには同じコマンドを使用してください。
#### **Windows PowerShell:**
```bash
irm https://unsloth.ai/install.ps1 | iex
```
更新するには同じコマンドを使用してください。
#### 起動:
```bash
unsloth studio -H 0.0.0.0 -p 8888
```
Unsloth Studio の詳細なインストール手順と要件については、 [ガイドを見る](/docs/jp/xin-gui/studio/install.md).
### **メインリポジトリからインストール**
#### **macOS、Linux、WSL の開発者向けインストール:**
```bash
git clone https://github.com/unslothai/unsloth
cd unsloth
./install.sh --local
unsloth studio -H 0.0.0.0 -p 8888
```
#### **Windows PowerShell の開発者向けインストール:**
```powershell
winget install -e --id Python.Python.3.13 --source winget
winget install --id=astral-sh.uv -e --source winget
winget install --id Git.Git -e --source winget
git clone https://github.com/unslothai/unsloth
cd unsloth
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1 --local
unsloth studio -H 0.0.0.0 -p 8888
```
### **夜間ビルドのインストール**
#### **Nightly - MacOS、Linux、WSL:**
```bash
git clone https://github.com/unslothai/unsloth
cd unsloth
git checkout nightly
./install.sh --local
```
その後、毎回起動するには:
```bash
unsloth studio -H 0.0.0.0 -p 8888
```
#### **Nightly - Windows:**
Windows PowerShell で実行:
```bash
winget install -e --id Python.Python.3.13 --source winget
winget install --id=astral-sh.uv -e --source winget
winget install --id Git.Git -e --source winget
git clone https://github.com/unslothai/unsloth
cd unsloth
git checkout nightly
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1 --local
```
その後、毎回起動するには:
unsloth studio -H 0.0.0.0 -p 8888
### アンインストール
Unsloth Studio を完全に削除するための推奨方法は、お使いの OS 用のアンインストールスクリプトを使うことです。実行中のサーバーを停止し、アプリ、CLI コマンド、ランチャーデータ、ショートカット、およびプラットフォーム固有のエントリ（macOS `.app` バンドル + Launch Services; Windows のスタートメニュー + レジストリ + PATH):
**macOS、WSL、Linux:**
```shellscript
curl -fsSL https://raw.githubusercontent.com/unslothai/unsloth/main/scripts/uninstall.sh | sh
```
**Windows (PowerShell):**
```ps1
irm https://raw.githubusercontent.com/unslothai/unsloth/main/scripts/uninstall.ps1 | iex
```
#### 手動でのアンインストール
特定の部分だけを削除したい場合:
**1. アプリのみを削除** （履歴、チャット、チェックポイント、エクスポートはそのまま保持されます）:
* **macOS、WSL、Linux:** `rm -rf ~/.unsloth/studio/unsloth_studio`
* **Windows (PowerShell):** `Remove-Item -Recurse -Force "$HOME\.unsloth\studio\unsloth_studio"`
**2. Unsloth を完全に削除** （他の Unsloth ツールはそのまま保持されます）:
* **macOS、WSL、Linux:** `rm -rf ~/.unsloth/studio`
* **Windows (PowerShell):** `Remove-Item -Recurse -Force "$HOME\.unsloth\studio"`
**3. Unsloth 関連をすべて削除:**
* **macOS、WSL、Linux:** `rm -rf ~/.unsloth`
* **Windows (PowerShell):** `Remove-Item -Recurse -Force "$HOME\.unsloth"`
{% hint style="warning" %}
注: 手順 1-5 では、ダウンロード済みの HF モデルファイルは削除されません。その容量を解放したい場合は、以下の「キャッシュされた HF モデルファイルの削除」を参照してください。
{% endhint %}
**4. ショートカットとシンボリックリンクを削除:**
**macOS:**
```shellscript
rm -rf ~/Applications/Unsloth\ Studio.app ~/Desktop/Unsloth\ Studio
```
**Linux:**
```shellscript
rm -f ~/.local/share/applications/unsloth-studio.desktop ~/Desktop/unsloth-studio.desktop
```
**WSL / Windows (PowerShell):**
```shellscript
Remove-Item -Force "$HOME\Desktop\Unsloth Studio.lnk"
Remove-Item -Force "$env:APPDATA\Microsoft\Windows\Start Menu\Programs\Unsloth Studio.lnk"
```
**5. CLI コマンドを削除:**
* **macOS、Linux、WSL:** `rm -f ~/.local/bin/unsloth`
* **Windows (PowerShell):** インストーラーは venv の `Scripts` ディレクトリをユーザーの PATH に追加しました。削除するには、設定 → システム → 詳細情報 → システムの詳細設定 → 環境変数 を開き、 `Path` をユーザー変数の下で探し、以下を指すエントリを削除してください `.unsloth\studio\...\Scripts`.
{% hint style="info" %}
注: 手順 1-5 では、ダウンロードした HF モデルファイルには触れません。その容量を取り戻したい場合は、以下の「キャッシュされた HF モデルファイルの削除」を参照してください。
{% endhint %}
### **キャッシュされた HF モデルファイルの削除**
古いモデルファイルは、モデル検索のゴミ箱アイコンから削除するか、デフォルトの Hugging Face キャッシュディレクトリから該当するキャッシュ済みモデルフォルダを削除して消せます。既定では、Hugging Face は `~/.cache/huggingface/hub/` を macOS/Linux/WSL で使用し、 `C:\Users\\.cache\huggingface\hub\` を Windows で使用します。
* **MacOS、Linux、WSL:** `~/.cache/huggingface/hub/`
* **Windows:** `%USERPROFILE%\.cache\huggingface\hub\`
もし `HF_HUB_CACHE` または `HF_HOME` が設定されている場合は、その場所を代わりに使用してください。Linux と WSL では、 `XDG_CACHE_HOME` で既定のキャッシュルートも変更できます。
## **Unsloth コア**
**以下のコマンドで uv をインストールしてください:**
**macOS、WSL、Linux:**
```shellscript
curl -LsSf https://astral.sh/uv/install.sh | sh
```
**Windows (PowerShell):**
```powershell
irm https://astral.sh/uv/install.ps1 | iex
```
**最新の pip リリース向けに、uv pip（推奨）で unsloth core をインストールしてください:**
```bash
uv venv unsloth_env --python 3.13
source unsloth_env/bin/activate
uv pip install unsloth --torch-backend=auto
```
または単に pip:
```bash
pip install unsloth
```
インストールするには **vLLM と Unsloth を** 同時にインストールするには、次を実行します:
```bash
uv pip install unsloth vllm --torch-backend=auto
```
Unsloth の **最新の main ブランチ** をインストールするには、次を実行します:
{% code overflow="wrap" %}
```bash
uv pip install unsloth --torch-backend=auto
pip uninstall unsloth unsloth_zoo -y && pip install --no-deps git+https://github.com/unslothai/unsloth_zoo.git && pip install --no-deps git+https://github.com/unslothai/unsloth.git
```
{% endcode %}
〜には **venv と仮想環境でのインストール** システムパッケージを壊さないようにインストールを分離し、システムへの修復不能な損害を減らすには、venv を使用してください:
{% code overflow="wrap" %}
```bash
apt install python3.10-venv python3.11-venv python3.12-venv python3.13-venv -y
python -m venv unsloth_env
source unsloth_env/bin/activate
pip install --upgrade pip && pip install uv
uv pip install unsloth --torch-backend=auto
```
{% endcode %}
Jupyter、Colab、または他のノートブックで Unsloth をインストールする場合は、必ずコマンドの前に `!`を付けてください。ターミナルを使う場合は必要ありません
{% hint style="info" %}
Python 3.13 がサポートされました！
{% endhint %}
### Unsloth Core をアンインストール
それでも Unsloth で依存関係の問題が発生する場合、多くのユーザーは Unsloth を強制アンインストールして再インストールすることで解決しています:
{% code overflow="wrap" %}
```bash
pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth
pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth_zoo
```
{% endcode %}
### 高度な Pip インストール
{% hint style="warning" %}
実行してください **決して** 以下の場合にこれを使用してください [Conda](/docs/jp/meru/install/conda-install.md).
{% endhint %}
依存関係の問題があるため、pip は少し複雑です。pip コマンドは以下に対して異なります `torch 2.2、2.3、2.4、2.5` および CUDA バージョン。
その他の torch バージョンについては、次をサポートしています `torch211`, `torch212`, `torch220`, `torch230`, `torch240` また、CUDA バージョンについては、次をサポートしています `cu118` と `cu121` と `cu124`。Ampere デバイス（A100、H100、RTX3090）以上では、以下を使用してください `cu118-ampere` または `cu121-ampere` または `cu124-ampere`.
たとえば、 `torch 2.4` と `CUDA 12.1`を使っている場合は、次を使用します:
```bash
pip install --upgrade pip
pip install "unsloth[cu121-torch240] @ git+https://github.com/unslothai/unsloth.git"
```
別の例として、 `torch 2.5` と `CUDA 12.4`を使っている場合は、次を使用します:
```bash
pip install --upgrade pip
pip install "unsloth[cu124-torch250] @ git+https://github.com/unslothai/unsloth.git"
```
その他の例:
```bash
pip install "unsloth[cu121-ampere-torch240] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu118-ampere-torch240] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu121-torch240] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu118-torch240] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu121-torch230] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu121-ampere-torch230] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu121-torch250] @ git+https://github.com/unslothai/unsloth.git"
pip install "unsloth[cu124-ampere-torch250] @ git+https://github.com/unslothai/unsloth.git"
```
または、以下をターミナルで実行して、 **最適な** pip インストールコマンドを取得します:
```bash
wget -qO- https://raw.githubusercontent.com/unslothai/unsloth/main/unsloth/_auto_install.py | python -
```
または、以下を Python REPL で手動実行してください:
{% code overflow="wrap" %}
```python
# Apache License, Version 2.0（「ライセンス」）の下でライセンスされています
try: import torch
except: raise ImportError('`pip install torch` を使って torch をインストールしてください')
from packaging.version import Version as V
import re
v = V(re.match(r"[0-9\.]{3,}", torch.__version__).group(0))
cuda = str(torch.version.cuda)
is_ampere = torch.cuda.get_device_capability()[0] >= 8
USE_ABI = torch._C._GLIBCXX_USE_CXX11_ABI
if cuda not in ("11.8", "12.1", "12.4", "12.6", "12.8", "13.0"): raise RuntimeError(f"CUDA = {cuda} not supported!")
if v <= V('2.1.0'): raise RuntimeError(f"Torch = {v} too old!")
elif v <= V('2.1.1'): x = 'cu{}{}-torch211'
elif v <= V('2.1.2'): x = 'cu{}{}-torch212'
elif v < V('2.3.0'): x = 'cu{}{}-torch220'
elif v < V('2.4.0'): x = 'cu{}{}-torch230'
elif v < V('2.5.0'): x = 'cu{}{}-torch240'
elif v < V('2.5.1'): x = 'cu{}{}-torch250'
elif v <= V('2.5.1'): x = 'cu{}{}-torch251'
elif v < V('2.7.0'): x = 'cu{}{}-torch260'
elif v < V('2.7.9'): x = 'cu{}{}-torch270'
elif v < V('2.8.0'): x = 'cu{}{}-torch271'
elif v < V('2.8.9'): x = 'cu{}{}-torch280'
elif v < V('2.9.1'): x = 'cu{}{}-torch290'
elif v < V('2.9.2'): x = 'cu{}{}-torch291'
else: raise RuntimeError(f"Torch = {v} too new!")
if v > V('2.6.9') and cuda not in ("11.8", "12.6", "12.8", "13.0"): raise RuntimeError(f"CUDA = {cuda} not supported!")
x = x.format(cuda.replace(".", ""), "-ampere" if False else "") # is_ampere は flash-attn のため壊れています
print(f'pip install --upgrade pip && pip install --no-deps git+https://github.com/unslothai/unsloth-zoo.git && pip install "unsloth[{x}] @ git+https://github.com/unslothai/unsloth.git" --no-build-isolation')
```
{% endcode %}
---
# 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/pip-install.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.