pip と uv で Unsloth をインストール

Pipを使ってUnslothをローカルにインストールするには、以下の手順に従ってください：

Unslothは2つの方法で使用できます： Unsloth Studio、Web UI、または Unsloth Core、コードベース版です。

Unsloth Studio

MacOS、Linux、WSL：

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

更新するには同じコマンドを使ってください。

Windows PowerShell：

irm https://unsloth.ai/install.ps1 | iex

更新するには同じコマンドを使ってください。

Unsloth Studioを起動：

unsloth studio -H 0.0.0.0 -p 8888

Unsloth Studioの詳細なインストール手順と要件については、 ガイドをご覧ください.

Unsloth Studioのアンインストール

Unsloth Studioは、通常次の場所にあるインストールフォルダを削除することでアンインストールできます。 $HOME/.unsloth/studio Mac/Linux/WSLでは、 %USERPROFILE%\.unsloth\studio Windowsでは、または次を実行してください：

• MacOS、WSL、Linux： rm -rf ~/.unsloth/studio

• Windows（PowerShell）： Remove-Item -Recurse -Force "$HOME\.unsloth\studio"

• オプション： 削除する $HOME\.unsloth Windowsでは、または ~/.unsloth MacOS/Linux/WSLで、Unslothのファイルをすべて削除したい場合

注意： rm -rf コマンドを使うと すべて削除されます。履歴、キャッシュ、チャットなども含まれます。

モデルファイルの削除

古いモデルファイルは、モデル検索のゴミ箱アイコンから削除するか、デフォルトのHugging Faceキャッシュディレクトリから該当するキャッシュ済みモデルフォルダを削除して消去できます。デフォルトでは、Hugging Faceは次を使用します。 ~/.cache/huggingface/hub/ macOS/Linux/WSLでは、 C:\Users\<username>\.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の依存関係の問題が発生する場合、多くのユーザーはUnslothを強制的にアンインストールして再インストールすることで解決しています：

pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth
pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth_zoo

Unsloth Core

最新のpipリリースでは、uv pip（推奨）でインストールしてください：

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：

pip install unsloth

インストールするには vLLMとUnslothを 一緒に、次を実行してください：

uv pip install unsloth vllm --torch-backend=auto

Unslothの 最新のmainブランチ をインストールするには、次を実行してください：

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

次の場合は、 venvと仮想環境のインストール を使ってインストールを分離し、システムパッケージを壊さないようにし、システムへの修復不能な損害を減らしてください：

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

Jupyter、Colab、または他のノートブックでUnslothをインストールする場合は、コマンドの前に !を付けてください。ターミナルを使う場合は必要ありません

Python 3.13が現在サポートされています！

Unsloth Coreのアンインストール

それでもUnslothの依存関係の問題が発生する場合、多くのユーザーはUnslothを強制的にアンインストールして再インストールすることで解決しています：

pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth
pip install --upgrade --force-reinstall --no-cache-dir --no-deps unsloth_zoo

高度なPipインストール

次の場合は 使わないでください ： Conda.

依存関係の問題があるため、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を使っている場合は、次を使用してください：

pip install --upgrade pip
pip install "unsloth[cu121-torch240] @ git+https://github.com/unslothai/unsloth.git"

別の例として、 torch 2.5 および CUDA 12.4を使っている場合は、次を使用してください：

pip install --upgrade pip
を使っている場合は、pip install "unsloth[cu124-torch250] @ git+https://github.com/unslothai/unsloth.git"

その他の例：

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インストールコマンドを取得してください：

wget -qO- https://raw.githubusercontent.com/unslothai/unsloth/main/unsloth/_auto_install.py | python -

または、以下をPython REPLで手動実行してください：

# Apache License, Version 2.0（「License」）に基づいてライセンスされています
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} はサポートされていません！")
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 "") # flash-attnのためis_ampereは壊れています
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')