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

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

Sie können jetzt Modelle direkt auf Ihrem lokalen Windows-Gerät ohne WSL feinabstimmen, indem Sie Unslotharrow-up-right verwenden. 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 Unsloth Studio veröffentlicht, die unter Windows sofort funktioniert:

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

Dann jedes Mal zum Starten:

unsloth studio -H 0.0.0.0 -p 8888

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

Unten stehen die 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-right. Um es zu verwenden, öffnen Sie zuerst PowerShell - suchen Sie im Startmenü nach „Windows PowerShell“:

Dann öffnet sich PowerShell:

Dann das Folgende kopieren und einfügen: STRG+C, und in PowerShell STRG+V einfügen:

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.

Der Installer wird 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 Folgendes 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 angezeigt wird, müssen Sie NVIDIA-Treiberarrow-up-right.

4

PyTorch installieren

Wenn Sie nvidia-smi ausführen, sehen Sie oben rechts: „CUDA Version: 13.0“. Installieren Sie PyTorch in PowerShell über. Ändern Sie 130 auf Ihre 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 über python auszuführen, 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

Sie sollten eine Matrix aus 10ern sehen. Prüfen Sie außerdem, ob beim ersten True zurückgegeben wird.

5

Unsloth installieren (nur wenn PyTorch funktioniert!)

triangle-exclamation

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

pip install unsloth
6

Prüfen, ob Unsloth funktioniert

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

Sie sollten Folgendes sehen:

🦥 Unsloth: Wir patchen Ihren Computer, um 2x schnelleres kostenloses Fine-Tuning zu ermöglichen.
🦥 Unsloth Zoo patcht jetzt alles, um das Training zu beschleunigen!
==((====))==  Unsloth 2026.1.4: Schnelles Gemma3-Patching. Transformers: 4.57.6.
   \\   /|    NVIDIA GeForce RTX 3060. Anzahl GPUs = 1. Maximale Speicherkapazität: 12,0 GB. Plattform: Windows.
O^O/ \_/ \    Torch: 2.10.0+cu130. CUDA: 8.6. CUDA Toolkit: 13.0. Triton: 3.6.0
\        /    Bfloat16 = WAHR. FA [Xformers = 0.0.34. FA2 = False]
 "-____-"     Kostenlose Lizenz: http://github.com/unslothai/unsloth
Unsloth: Schnelles Herunterladen ist aktiviert - ignorieren Sie Download-Balken in roter Farbe!
Unsloth: Gemma3 unterstützt SDPA nicht - wechsle zu schnellem Eager.
Unsloth: Mache `model.base_model.model.model` gradientspflichtig
Unsloth: Tokenisierung von ["text"] (num_proc=1):   0%|                 | 0/210289 [00:00<?, ? examples/s]�  Unsloth: Wir patchen Ihren Computer, um 2x schnelleres kostenloses Fine-Tuning zu ermöglichen.
🦥 Unsloth: Wir patchen Ihren Computer, um 2x schnelleres kostenloses Fine-Tuning zu ermöglichen.

Und Training:

Methode #2 - Docker:

Docker ist möglicherweise der einfachste Weg für Windows-Nutzer, mit Unsloth zu starten, 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 dasselbe Image - kein separates Image erforderlich.

Für Installationsanweisungen folgen Sie bitte unserem Docker-Leitfaden, andernfalls hier ein Schnellstart-Leitfaden:

1

Installieren Sie Docker und das NVIDIA Container Toolkit.

Installieren Sie Docker über Linuxarrow-up-right oder Desktoparrow-up-right (andere). 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 -Tabs zu, um Unsloth-Notebooks zu sehen.

4

Mit Unsloth mit dem Training beginnen

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

5

Docker-Probleme - GPU nicht erkannt?

Versuchen Sie es mit 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 ausgeführt 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 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

Dann öffnen Sie unsere Notebooks innerhalb von Unsloth-Notebooksund laden Sie sie! Sie können auch zu Colab-Notebooks gehen und herunterladen > .ipynb herunterladen 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. 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 andere Möglichkeit ist, flash-attn für Ampere-GPUs zu installieren.

  5. Vergewissern Sie sich erneut, dass Ihre Versionen von Python, CUDA, CUDNN, torch, tritonund xformers miteinander kompatibel sind. Die PyTorch-Kompatibilitätsmatrixarrow-up-right kann nützlich sein.

  6. Schließlich installieren Sie bitsandbytes und prüfen Sie es mit python -m bitsandbytes

Zuletzt aktualisiert

War das hilfreich?