windowsUnsloth auf Windows installieren

Sieh, wie du Unsloth unter Windows installierst, um mit dem lokalen Finetuning von LLMs zu beginnen.

Erfahren Sie, wie Sie LLMs direkt auf Ihrem Windows-Gerät ohne WSL mit Unsloth feinabstimmen können. Für Windows pip install unsloth funktioniert, allerdings muss PyTorch zuvor installiert sein. Andernfalls können Sie unseren Guides unten folgen:

Conda-TutorialDocker-TutorialWSL-Tutorial

Methode #1 - Windows via Conda:

1

Installieren Sie Miniconda (oder Anaconda)

Anaconda herunterladen hierarrow-up-right. Unser Vorschlag ist die Verwendung von Minicondaarrow-up-right. Um es zu verwenden, öffnen Sie zuerst Powershell - suchen Sie im Startmenü nach "Windows Powershell":

Dann öffnet sich Powershell:

Dann kopieren Sie das Folgende: STRG+C und fügen es in Powershell mit STRG+V ein:

Invoke-WebRequest -Uri "https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe" -OutFile ".\miniconda.exe"
Start-Process -FilePath ".\miniconda.exe" -ArgumentList "/S" -Wait
del .\miniconda.exe

Akzeptieren Sie die Warnung und drücken Sie „Trotzdem einfügen“ und warten Sie.

Der Installer wird wie unten heruntergeladen:

Nach der Installation öffnen Sie Anaconda Powershell Prompt um Miniconda über Start -> Suche zu verwenden:

Dann sehen Sie:

2

Conda-Umgebung erstellen

conda create --name unsloth_env python==3.12 -y
conda activate unsloth_env

Sie werden sehen:

3

Prüfen nvidia-smi um zu bestätigen, dass Sie eine GPU haben, und um die CUDA-Version zu überprüfen

Nach Eingabe von nvidia-smi in Powershell sollten Sie etwas wie unten sehen. Wenn Sie nicht nvidia-smi oder das Folgende nicht erscheint, müssen Sie NVIDIA-Treiberarrow-up-right.

4

neu installieren

PyTorch installieren nvidia-smi Beim Ausführen 130 sehen Sie oben rechts: "CUDA Version: 13.0". Installieren Sie PyTorch in PowerShell. Ändern Sie auf Ihre CUDA-Version - stellen Sie sicher, dass diearrow-up-right Version existiert

und mit Ihrer CUDA-Treiberversion übereinstimmt.

Sie werden sehen:

pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu130 Versuchen Sie dies in Python auszuführen via python

nachdem PyTorch installiert ist:
import torch
print(torch.cuda.is_available())
A = torch.ones((10, 10), device = "cuda")
B = torch.ones((10, 10), device = "cuda")

A @ B

5

Sie sollten eine Matrix mit 10ern sehen. Überprüfen Sie außerdem, dass für das Erste True ausgegeben wird.

triangle-exclamation

Bestätigen Sie, dass PyTorch einwandfrei funktioniert und ausgeführt wird – wenn nicht, ist PyTorch defekt und das bedeutet leider, dass Ihr Windows-Rechner möglicherweise eine Neuinstallation der CUDA-Treiber benötigt. In Powershell (nach dem Verlassen von Python via exit()

pip install unsloth
6

, führen Sie aus und warten Sie:

Überprüfen Sie, ob Unsloth funktioniert Unsloth-Notebooks Verwenden Sie nun ein beliebiges Skript in

trainer.train()

Sie sollten sehen:
🦥 Unsloth: Wird Ihren Computer patchen, um kostenloses Fine-Tuning 2x schneller zu ermöglichen.
🦥 Unsloth Zoo wird nun alles patchen, um das Training zu beschleunigen!
   ==((====))==  Unsloth 2026.1.4: Schnelles Gemma3-Patching. Transformers: 4.57.6.
\\   /|    NVIDIA GeForce RTX 3060. Anzahl GPUs = 1. Max. Speicher: 12,0 GB. Plattform: Windows.
O^O/ \_/ \    Torch: 2.10.0+cu130. CUDA: 8.6. CUDA Toolkit: 13.0. Triton: 3.6.0
 \        /    Bfloat16 = TRUE. FA [Xformers = 0.0.34. FA2 = False]
"-____-"     Kostenlose Lizenz: http://github.com/unslothai/unsloth
Unsloth: Schnellladen ist aktiviert  ignorieren Sie Downloadleisten, die rot gefärbt sind!
Unsloth: Gemma3 unterstützt SDPA nicht  wechsle zu schnellem Eager-Modus.
Unsloth: Setze `model.base_model.model.model` auf benötigte Gradienten
Sie sollten sehen:

Unsloth: Tokenisiere ["text"] (num_proc=1): 0%| | 0/210289 [00:00<?, ? examples/s]� Unsloth: Wird Ihren Computer patchen, um kostenloses Fine-Tuning 2x schneller zu ermöglichen.

Und Training:

Methode #2 - Docker: Docker könnte für Windows-Nutzer der einfachste Weg sein, mit Unsloth zu beginnen, da keine Einrichtung oder Abhängigkeitsprobleme anfallen.arrow-up-right unsloth/unsloth ist Unsloths einziges Docker-Image. Für Blackwell

und 50er-Serie GPUs verwenden Sie dasselbe Image – kein separates Image erforderlich. Für Installationsanweisungen folgen Sie bitte unseremDocker-Guide

1

, ansonsten hier eine Schnellstart-Anleitung:

Installieren Sie Docker und das NVIDIA Container Toolkit. Installieren Sie Docker überarrow-up-right Linux oderarrow-up-right Desktop (andere). Installieren Sie dannarrow-up-right:

NVIDIA Container Toolkit
export NVIDIA_CONTAINER_TOOLKIT_VERSION=1.17.8-1
  sudo apt-get update && sudo apt-get install -y \
  nvidia-container-toolkit=${NVIDIA_CONTAINER_TOOLKIT_VERSION} \
  nvidia-container-toolkit-base=${NVIDIA_CONTAINER_TOOLKIT_VERSION} \
  libnvidia-container-tools=${NVIDIA_CONTAINER_TOOLKIT_VERSION} \
2

libnvidia-container1=${NVIDIA_CONTAINER_TOOLKIT_VERSION}

Docker könnte für Windows-Nutzer der einfachste Weg sein, mit Unsloth zu beginnen, da keine Einrichtung oder Abhängigkeitsprobleme anfallen.arrow-up-right Starten Sie den Container.

ist Unsloths einziges Docker-Image.
  docker run -d -e JUPYTER_PASSWORD="mypassword" \
  -p 8888:8888 -p 2222:22 \
  -v $(pwd)/work:/workspace/work \
  Docker könnte für Windows-Nutzer der einfachste Weg sein, mit Unsloth zu beginnen, da keine Einrichtung oder Abhängigkeitsprobleme anfallen.
3

--gpus all \

Auf Jupyter Lab zugreifen Gehen Sie zuarrow-up-right http://localhost:8888 und öffnen Sie Unsloth. Greifen Sie auf die unsloth-notebooks

4

Tabs zu, um die Unsloth-Notebooks zu sehen.

Beginnen Sie mit dem Training mit Unsloth Wenn Sie neu sind, folgen Sie unserem Schritt-für-Schritt-, Fine-Tuning-Guide RL-Guide oder speichern/kopieren Sie einfach eines unserer vorgefertigten.

5

Notebooks

Docker-Probleme - GPU nicht erkannt? Windows

Versuchen Sie WSL via

1

Methode #3 - WSL:

Installieren Sie WSL

Öffnen Sie die Eingabeaufforderung oder das Terminal und installieren Sie Ubuntu. Legen Sie das Passwort fest, falls Sie dazu aufgefordert werden.
wsl.exe --install Ubuntu-24.04
2

wsl.exe -d Ubuntu-24.04$primary , betreten Sie WSL durch Eingabe von wsl

, betreten Sie WSL durch Eingabe von
3

und DRÜCKEN SIE ENTER in der Eingabeaufforderung

Python installieren
sudo apt update
4

neu installieren

sudo apt install python3 python3-full python3-pip python3-venv -y

pip install torch torchvision --force-reinstall --index-url https://download.pytorch.org/whl/cu130 Wenn Sie Berechtigungsprobleme haben, verwenden Sie –break-system-packages so

5

pip install torch torchvision --force-reinstall --index-url https://download.pytorch.org/whl/cu130 –break-system-packages

Installieren Sie Unsloth und Jupyter Notebook

pip install torch torchvision --force-reinstall --index-url https://download.pytorch.org/whl/cu130 pip install unsloth jupyter –break-system-packages –-break-system-packages

6

pip install unsloth jupyter –-break-system-packages

Unsloth über Jupyter Notebook starten

jupyter notebook Unsloth-NotebooksÖffnen Sie dann unsere Notebooks innerhalb von

circle-exclamation

Wenn Sie GRPO verwenden oder vLLM einsetzen möchten: Derzeit unterstützt vLLM Windows nicht direkt, sondern nur über WSL oder Linux. Fehlerbehebung /

Erweitert Für erweiterte Installationsanweisungen

  1. oder falls Sie während der Installation seltsame Fehler sehen: Installieren Sie torch undtriton . Gehen Sie zu https://pytorch.org, um es zu installieren. Zum Beispiel

  2. pip install torch torchvision torchaudio triton Überprüfen Sie, ob CUDA korrekt installiert ist. Versuchen Sienvcc . Wenn das fehlschlägt, müssen Sie cudatoolkit

  3. oder falls Sie während der Installation seltsame Fehler sehen: Intel-Windows-Anleitung folgen und xformers manuell installieren. Sie können versuchen, xformers vllm Intel-Windows-Anleitung zu installieren und zu sehen, ob erfolgreich ist. Prüfen Sie, ob mit python -m xformers.info erfolgreich ausgeführt wurde. Gehen Sie zu https://github.com/facebookresearch/xformers. Eine weitere Option ist,

  4. flash-attn Installieren Sie, undfür Ampere-GPUs zu installieren. Intel-Windows-Anleitung Überprüfen Sie nochmals, dass Ihre Versionen von Python, CUDA, CUDNN, , undarrow-up-right miteinander kompatibel sind. Die

  5. PyTorch-Kompatibilitätsmatrix kann hilfreich sein. Installieren Sie schließlich bitsandbytes

Zuletzt aktualisiert

War das hilfreich?