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

Sieh, wie du Unsloth unter Windows installierst, 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 es funktionieren. Andernfalls folgen Sie unseren Anleitungen unten:

Conda-TutorialDocker-TutorialWSL-Tutorial

Unsloth Studio

Wir haben eine neue Web-UI namens Unsloth Studio veröffentlicht, die unter Windows sofort funktioniert:

irm https://raw.githubusercontent.com/unslothai/unsloth/main/install.ps1 | iex

Dann zum jedes Mal Starten:

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

Für detaillierte Installationsanweisungen und Anforderungen für Unsloth Studio sehen Sie sich unseren Leitfaden an.

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

Methode #1 - Windows via Conda:

1

Miniconda (oder Anaconda) installieren

Anaconda herunterladen hierarrow-up-right. Unsere Empfehlung 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 den folgenden Text kopieren und einfügen: CTRL+C, und in PowerShell einfügen CTRL+V:

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 klicken Sie auf "Trotzdem einfügen" und warten Sie.

Es wird der Installer wie unten heruntergeladen:

Nach der Installation öffnen Sie 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 sehen:

3

Prüfen nvidia-smi um zu bestätigen, dass Sie eine GPU haben, und suchen Sie nach der 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 vorhanden istarrow-up-right und mit Ihrer CUDA-Treiberversion übereinstimmt.

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

Sie werden sehen:

Versuchen Sie, dies in Python auszuführen über python nachdem PyTorch installiert wurde:

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 der erste Wert True ist.

5

Unsloth installieren (nur wenn PyTorch funktioniert!)

triangle-exclamation

In PowerShell (nach dem Beenden von Python über exit() , ausführen und warten:

pip install unsloth
6

Überprüfen Sie, ob Unsloth funktioniert

Verwenden Sie nun jedes Skript in Unsloth-Notebooks (als .py-Datei speichern) oder verwenden Sie das folgende grundlegende Skript:

Sie sollten sehen:

🦥 Unsloth: Wir werden Ihren Computer patchen, um 2x schnelleres kostenloses Finetuning zu ermöglichen.
🦥 Unsloth Zoo wird jetzt alles patchen, um das Training zu beschleunigen!
==((====))==  Unsloth 2026.1.4: Schnelles Gemma3-Patching. Transformers: 4.57.6.
   \\   /|    NVIDIA GeForce RTX 3060. Num GPUs = 1. Max memory: 12.0 GB. Platform: 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]
 "-____-"     Freie 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 - Wechsel zu schnellem eager.
Unsloth: `model.base_model.model.model` auf Gradientenpflicht setzen
Unsloth: Tokenisieren ["text"] (num_proc=1):   0%|                 | 0/210289 [00:00<?, ? examples/s]�  Unsloth: Wir werden Ihren Computer patchen, um 2x schnelleres kostenloses Finetuning zu ermöglichen.
🦥 Unsloth: Wir werden Ihren Computer patchen, um 2x schnelleres kostenloses Finetuning zu ermöglichen.

Und das Training:

Methode #2 - Docker:

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

Für Installationsanweisungen folgen Sie bitte unserer Docker-Anleitung, andernfalls hier eine Schnellstartanleitung:

1

Docker und NVIDIA Container Toolkit installieren.

Docker über Linuxarrow-up-right oder Desktoparrow-up-right (andere) installieren. 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

Den Container ausführen.

unsloth/unslotharrow-up-right ist das einzige Docker-Image von Unsloth.

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. Rufen Sie die unsloth-notebooks Tabs auf, um Unsloth-Notebooks zu sehen.

4

Mit Unsloth mit dem Training beginnen

Wenn Sie neu sind, folgen Sie unserer Schritt-für-Schritt Fine-Tuning-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. Setzen Sie das Passwort, 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 die Eingabeaufforderung eingeben

3

Python installieren

4

PyTorch installieren

Wenn Sie auf Berechtigungsprobleme stoßen, verwenden Sie –break-system-packages damit 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 auf Berechtigungsprobleme stoßen, verwenden Sie –-break-system-packages damit pip install unsloth jupyter –-break-system-packages

6

Unsloth über Jupyter Notebook starten

Dann öffnen Sie unsere Notebooks innerhalb von Unsloth-Notebooksund laden Sie sie! Sie können auch zu Colab-Notebooks gehen und download > download .ipynb wählen und sie laden.

circle-exclamation

Fehlerbehebung / Erweitert

Für erweiterte Installationsanweisungen oder wenn Sie während der Installation 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. Wenn 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 folgen. 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 weitere Option ist die Installation von flash-attn für Ampere-GPUs.

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

  6. Installieren Sie schließlich bitsandbytes und prüfen Sie es mit python -m bitsandbytes

Zuletzt aktualisiert

War das hilfreich?