windowsWie man LLMs unter Windows mit Unsloth feinabstimmt (Schritt-für-Schritt-Anleitung)

Sieh dir an, wie man Unsloth unter Windows installiert, um mit dem lokalen Fine-Tuning von LLMs zu beginnen.

Sie können Modelle jetzt direkt auf Ihrem lokalen Windows-Gerät ohne WSL feinabstimmen, indem Sie Unslotharrow-up-right. Für diese Anleitung gibt es 3 Hauptmethoden, die Sie verwenden können (Conda, Docker und WSL). Wenn Sie PyTorch bereits unter Windows installiert haben, pip install unsloth sollte funktionieren. Andernfalls folgen Sie unseren Anleitungen unten:

Conda-TutorialDocker-TutorialWSL-Tutorial

Unsloth Studio

Wir haben eine neue Web-UI namens gestartet Unsloth Studio die auf Windows sofort funktioniert:

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

Dann jedes Mal zum Starten:

& .\unsloth_studio\Scripts\unsloth.exe studio -H 0.0.0.0 -p 8888

Für detaillierte Installationsanweisungen und Anforderungen für Unsloth Studio, siehe unseren Leitfaden.

Unten finden Sie Installationsanweisungen für das ursprüngliche Unsloth Core:

Methode #1 - Windows über Conda:

1

Miniconda (oder Anaconda) installieren

Anaconda herunterladen hierarrow-up-right. Unsere Empfehlung ist, Minicondaarrow-up-rightzu verwenden. Um es zu nutzen, öffnen Sie zuerst PowerShell – suchen Sie im Startmenü nach „Windows PowerShell“:

Dann öffnet sich PowerShell:

Dann kopieren und fügen Sie das Folgende ein: STRG+C und fügen Sie 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.

Es lädt den Installer wie unten herunter:

Nach der Installation öffnen Sie öffnen Anaconda PowerShell Prompt um Miniconda über Start -> danach suchen zu verwenden:

Dann sehen Sie:

2

Conda-Umgebung erstellen

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

Sie werden Folgendes sehen:

3

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

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

4

PyTorch installieren

Beim Ausführen von nvidia-smi sehen Sie oben rechts: „CUDA Version: 13.0“. Installieren Sie PyTorch in PowerShell über. Ändern Sie 130 entsprechend Ihrer CUDA-Version – stellen Sie sicher, dass die Version existiertarrow-up-right und mit Ihrer CUDA-Treiberversion übereinstimmt.

pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu130

Sie werden Folgendes sehen:

Versuchen Sie dies in Python auszuführen über python nach der Installation von PyTorch:

import torch
print(torch.cuda.is_available())
A = torch.ones((10, 10), device = "cuda")
B = torch.ones((10, 10), device = "cuda")
A @ B

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

5

Unsloth installieren (nur wenn PyTorch funktioniert!)

triangle-exclamation

In PowerShell (nachdem Sie Python mit exit() verlassen haben, ausführen und warten:

pip install unsloth
6

Überprüfen, ob Unsloth funktioniert

Verwenden Sie jetzt beliebige Skripte in Unsloth-Notebooks (als .py-Datei speichern) oder verwenden Sie das untenstehende einfache Skript:

Sie sollten Folgendes sehen:

🦥 Unsloth: Wir werden Ihren Computer patchen, um 2x schnelleres kostenloses Feintuning zu ermöglichen.
🦥 Unsloth Zoo wird jetzt alles patchen, um das Training schneller zu machen!
==((====))==  Unsloth 2026.1.4: Schnelles Gemma3-Patching. Transformers: 4.57.6.
   \\   /|    NVIDIA GeForce RTX 3060. Anzahl GPUs = 1. Maximaler 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: Schnelles Herunterladen ist aktiviert  ignorieren Sie Download-Balken, die rot gefärbt sind!
Unsloth: Gemma3 unterstützt SDPA nicht  Umschalten auf schnelles eager.
Unsloth: `model.base_model.model.model` auf Gradientenpflicht setzen
Unsloth: Tokenizing ["text"] (num_proc=1):   0%|                 | 0/210289 [00:00<?, ? examples/s]�  Unsloth: Wir werden Ihren Computer patchen, um 2x schnelleres kostenloses Feintuning zu ermöglichen.
🦥 Unsloth: Wir werden Ihren Computer patchen, um 2x schnelleres kostenloses Feintuning zu ermöglichen.

Und Training:

Methode #2 - Docker:

Docker ist möglicherweise der einfachste Weg für Windows-Nutzer, mit Unsloth zu beginnen, da keine Einrichtung oder Abhängigkeitsprobleme erforderlich sind. unsloth/unslotharrow-up-right ist Unsloths einziges Docker-Image. Für Blackwell und GPUs der 50er-Serie verwenden Sie dieses gleiche Image – kein separates Image erforderlich.

Für Installationsanweisungen folgen Sie bitte unserem Docker-Leitfaden, andernfalls hier ist eine Schnellstartanleitung:

1

Installieren Sie Docker und das NVIDIA Container Toolkit.

Docker installieren über Linuxarrow-up-right oder Desktoparrow-up-right (sonstiges). Dann installieren Sie NVIDIA Container Toolkitarrow-up-right:

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} \
  libnvidia-container1=${NVIDIA_CONTAINER_TOOLKIT_VERSION}
2

Führen Sie den Container aus.

unsloth/unslotharrow-up-right ist Unsloths einziges Docker-Image.

docker run -d -e JUPYTER_PASSWORD="mypassword" \
  -p 8888:8888 -p 2222:22 \
  -v $(pwd)/work:/workspace/work \
  --gpus all \
  unsloth/unsloth
3

Jupyter Lab aufrufen

Gehen Sie zu http://localhost:8888arrow-up-right und öffnen Sie Unsloth. Greifen Sie auf die unsloth-notebooks Registerkarten zu, um Unsloth-Notebooks zu sehen.

4

Mit Unsloth mit dem Training beginnen

Wenn Sie neu sind, folgen Sie unserer Schritt-für-Schritt- Feintuning-Anleitung, RL-Anleitung oder speichern/kopieren Sie einfach eines unserer vorgefertigten Notebooks.

5

Docker-Probleme - GPU nicht erkannt?

Versuchen Sie WSL über Windows

Methode #3 - WSL:

1

WSL installieren

Öffnen Sie die Eingabeaufforderung, das Terminal, und installieren Sie Ubuntu. Legen Sie das Passwort fest, falls Sie dazu aufgefordert werden.

2

Wenn Sie (1) NICHT gemacht haben, also WSL bereits installiert haben, geben Sie WSL ein, indem Sie wsl und ENTER in der Eingabeaufforderung eingeben

3

Python installieren

4

PyTorch installieren

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

5

Unsloth und Jupyter Notebook installieren

Wenn Sie Berechtigungsprobleme haben, verwenden Sie –-break-system-packages also pip install unsloth jupyter –-break-system-packages

6

Unsloth über Jupyter Notebook starten

Öffnen Sie dann unsere Notebooks innerhalb von Unsloth-Notebooksund laden Sie sie! Sie können auch zu Colab-Notebooks gehen, dort auf Herunterladen > .ipynb herunterladen klicken und sie laden.

circle-exclamation

Fehlerbehebung / Erweitert

Für erweiterte Installationsanweisungen oder wenn Sie bei Installationen seltsame Fehler sehen:

  1. Installieren Sie torch und triton. Gehen Sie zu https://pytorch.org, um es zu installieren. Zum Beispiel pip install torch torchvision torchaudio triton

  2. Bestätigen Sie, ob CUDA korrekt installiert ist. Versuchen Sie nvcc. Falls das fehlschlägt, müssen Sie cudatoolkit oder CUDA-Treiber installieren.

  3. Wenn Sie eine Intel-GPU verwenden, müssen Sie unserer Intel-Windows-Anleitung

  4. Installieren Sie xformers manuell installieren. Sie können versuchen, vllm zu installieren und zu sehen, ob vllm erfolgreich ist. Prüfen Sie, ob xformers erfolgreich war mit python -m xformers.info Gehen Sie zu https://github.com/facebookresearch/xformers. Eine andere Option ist, flash-attn für Ampere-GPUs zu installieren.

  5. Überprüfen Sie noch einmal, ob Ihre Versionen von Python, CUDA, CUDNN, torch, triton, und xformers miteinander kompatibel sind. Die PyTorch-Kompatibilitätsmatrixarrow-up-right kann nützlich sein.

  6. Installieren Sie abschließend bitsandbytes und prüfen Sie es mit python -m bitsandbytes

Zuletzt aktualisiert

War das hilfreich?