For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 -H 0.0.0.0 -p 8888

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

メインリポジトリからインストール

macOS、Linux、WSL の開発者向けインストール:

git clone https://github.com/unslothai/unsloth
cd unsloth
./install.sh --local
unsloth studio -H 0.0.0.0 -p 8888

Windows PowerShell の開発者向けインストール:

ナイトリー版のインストール

ナイトリー版 - MacOS、Linux、WSL:

その後、毎回起動するには:

ナイトリー版 - Windows:

Windows PowerShell で実行:

その後、毎回起動するには:

アンインストール

Unsloth Studio を完全に削除する推奨方法は、OS 用のアンインストールスクリプトを使うことです。実行中のサーバーを停止し、アプリ、CLI コマンド、ランチャーデータ、ショートカット、およびプラットフォーム固有の項目(macOS .app バンドル + Launch Services;Windows スタートメニュー + レジストリ + PATH)を削除します:

macOS、WSL、Linux:

Windows(PowerShell):

手動アンインストール

特定の部分だけを削除したい場合:

1. アプリのみ削除 (履歴、チャット、チェックポイント、エクスポートはそのまま保持されます):

  • macOS、WSL、Linux: rm -rf ~/.unsloth/studio/unsloth_studio

  • Windows(PowerShell): Remove-Item -Recurse -Force "$HOME\.unsloth\studio\unsloth_studio"

2. Studio を完全に削除 (他の 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"

4. ショートカットとシンボリックリンクを削除:

macOS:

Linux:

WSL / Windows(PowerShell):

5. CLI コマンドを削除:

  • macOS、Linux、WSL: rm -f ~/.local/bin/unsloth

  • Windows(PowerShell): インストーラーは venv の Scripts ディレクトリをユーザーの PATH に追加しました。削除するには、設定 → システム → 詳細情報 → 高度なシステム設定 → 環境変数 を開き、 Path をユーザー変数の下で見つけ、 .unsloth\studio\...\Scripts.

注意:手順 1〜5 では、ダウンロードした HF モデルファイルには触れません。その容量を回収したい場合は、下記のキャッシュ済み HF モデルファイルの削除を参照してください。

キャッシュ済み HF モデルファイルの削除

古いモデルファイルは、モデル検索のゴミ箱アイコンから削除するか、既定の 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 Core

次のコマンドで uv をインストールします:

macOS、WSL、Linux:

Windows(PowerShell):

最新の pip リリース向けに、uv pip で unsloth core をインストールします(推奨):

または、単に pip で:

インストールするには vLLM と Unsloth を一緒に、次を実行します:

Unsloth の 最新の main ブランチ をインストールするには、次を実行します:

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

Jupyter、Colab、その他のノートブックに Unsloth をインストールする場合は、コマンドの前に !を付けてください。ターミナルを使用する場合は不要です

Python 3.13 がサポートされました!

Unsloth Core をアンインストール

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

高度な pip インストール

がある場合は。依存関係の問題があるため、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を使用している場合は、次を使用します:

別の例として、 torch 2.5 および CUDA 12.4を使用している場合は、次を使用します:

他の例:

または、以下をターミナルで実行して、 最適な pip インストールコマンドを取得します:

または、以下を Python REPL で手動実行します:

最終更新

役に立ちましたか?