# pipとuvでUnslothをインストール
Unslothは2つの方法で使用できます： [Unsloth Studio](#unsloth-studio)、Web UI、または [Unsloth Core](#unsloth-core)、コードベース版を通して。
## **Unsloth Studio**
#### **MacOS、Linux、WSL：**
```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```
更新するには同じコマンドを使うか、 `unsloth studio update`.
#### **Windows PowerShell：**
```bash
irm https://unsloth.ai/install.ps1 | iex
```
更新するには同じコマンドを使うか、 `unsloth studio update`.
#### 起動：
```bash
unsloth studio -H 0.0.0.0 -p 8888
```
Unsloth Studio の詳細なインストール手順と要件については、 [ガイドをご覧ください](/docs/jp/xin-zhe/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
```
### **ナイトリー版インストール**
#### **ナイトリー版 - 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
```
#### **ナイトリー版 - 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 をアンインストールするには、次の4手順に従ってください：
#### **1. アプリケーションを削除する**
* MacOS、WSL、Linux： `rm -rf ~/.unsloth/studio/unsloth_studio`
* Windows（PowerShell）： `Remove-Item -Recurse -Force "$HOME\.unsloth\studio\unsloth_studio"`
これによりアプリケーションは削除されますが、モデルのチェックポイント、エクスポート、履歴、キャッシュ、チャットはそのまま保持されます。
#### **2. ショートカットとシンボリックリンクを削除する**
**macOS：**
```bash
rm -rf ~/Applications/Unsloth\ Studio.app ~/Desktop/Unsloth\ Studio
```
**Linux：**
```bash
rm -f ~/.local/share/applications/unsloth-studio.desktop ~/Desktop/unsloth-studio.desktop
```
**WSL / Windows（PowerShell）：**
```bash
Remove-Item -Force "$HOME\Desktop\Unsloth Studio.lnk"
Remove-Item -Force "$env:APPDATA\Microsoft\Windows\Start Menu\Programs\Unsloth Studio.lnk"
```
#### **3. CLI コマンドを削除する**
**macOS、Linux、WSL：**
```bash
rm -f ~/.local/bin/unsloth
```
**Windows（PowerShell）：** インストーラーは venv の `Scripts` ディレクトリをユーザー PATH に追加しました。削除するには、設定 → システム → 詳細情報 → システムの詳細設定 → 環境変数 を開き、 `Path` をユーザー変数の下で見つけ、次を指すエントリを削除してください `.unsloth\studio\...\Scripts`.
#### **4. すべて削除する（任意）**
履歴、キャッシュ、チャット、モデルのチェックポイント、モデルのエクスポートも削除するには、Unsloth フォルダ全体を削除してください：
* MacOS、WSL、Linux： `rm -rf ~/.unsloth`
* Windows（PowerShell）： `Remove-Item -Recurse -Force "$HOME\.unsloth"`
ダウンロードした HF モデルファイルは Hugging Face のキャッシュに別途保存されることに注意してください。上記の手順ではそれらは削除されません。ディスク容量を解放したい場合は、下の **モデルファイルの削除** を参照してください。
{% hint style="warning" %}
注意: `rm -rf` コマンドを使用すると **すべてが削除されます**。履歴、キャッシュ、チャットなども含まれます。
{% 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 Core**
**最新の pip リリースを使用するには、uv pip でインストールすることを推奨します:**
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
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 (the "License") の下でライセンスされています
try: import torch
except: raise ImportError('torch を `pip install 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} はサポートされていません!")
if v <= V('2.1.0'): raise RuntimeError(f"Torch = {v} は古すぎます!")
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} は新しすぎます!")
if v > V('2.6.9') and cuda not in ("11.8", "12.6", "12.8", "13.0"): raise RuntimeError(f"CUDA = {cuda} はサポートされていません!")
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: 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:
```
GET https://unsloth.ai/docs/jp/meru/install/pip-install.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.