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

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

Unsloth スタジオ

MacOS、Linux、WSL：

MacOS の場合、次があることを確認してください cmake がインストールされていること。インストールされていない場合は実行してください brew install cmake.

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv unsloth_studio --python 3.13
source unsloth_studio/bin/activate
uv pip install unsloth --torch-backend=auto
unsloth studio setup
unsloth studio -H 0.0.0.0 -p 8888

Windows PowerShell：

winget install -e --id Python.Python.3.13
winget install --id=astral-sh.uv  -e
uv venv unsloth_studio --python 3.13
.\unsloth_studio\Scripts\activate
uv pip install unsloth --torch-backend=auto
unsloth studio setup
unsloth studio -H 0.0.0.0 -p 8888

Unsloth を起動

MacOS、Linux、WSL：

source unsloth_studio/bin/activate
unsloth studio -H 0.0.0.0 -p 8888

Windows：

.\unsloth_studio\Scripts\activate
unsloth studio -H 0.0.0.0 -p 8888

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

Unsloth コア

最新の 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 と仮想環境でのインストール インストールをシステムパッケージを壊さないように分離し、システムへの修復不能な損傷を減らすために、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 の依存関係の問題が発生する場合、多くのユーザーは 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 インストールコマンドを取得するために、下をターミナルで実行してください： 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('Install torch via `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} 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')