KI-Werkzeuge unter Windows einrichten: WSL erklärt, mit Anleitung und Fehlersuche

Obsidian läuft unter Windows. Auch die lokalen Python-Beispiele dieser Serie kannst du direkt in PowerShell ausführen. WSL brauchst du erst, wenn du zusätzlich mit Linux-Werkzeugen arbeiten möchtest, etwa dem tmux-Beispiel aus dem letzten Serienteil.

Die Serie als Video

Das Video zur Serie zeigt in gut sechs Minuten, wie die Teile zusammenpassen. Die Angaben im Umzugsbeispiel sind erfunden.

Diese Anleitung ist deshalb ein Zusatz, kein weiterer Pflichtschritt. Sie erklärt, was WSL verändert, wie du es installierst und woran du erkennst, ob du gerade in Windows oder Linux arbeitest.

Die ergänzende WSL-Anleitung liegt ebenfalls auf GitHub. Die übrigen Beispiele findest du in der Serienübersicht auf GitHub.

Was WSL ist

WSL bedeutet Windows Subsystem for Linux. Es stellt eine Linux-Umgebung innerhalb von Windows bereit. Du kannst darin Linux-Befehle und Programme ausführen und trotzdem deine Windows-Anwendungen weiterverwenden. Für die folgende Anleitung verwenden wir Ubuntu.

Windows und die Linux-Umgebung haben eigene Programme und Dateipfade. Ein unter Windows installiertes Python ist nicht automatisch dein Linux-Python. Ein PowerShell-Befehl gehört nicht unverändert in eine Linux-Shell. Genau diese Unterscheidung vermeidet viele Fehler beim Kopieren von Anleitungen.

Vor der Installation prüfen

Microsoft nennt für den einfachen Installationsbefehl Windows 10 ab Version 2004, Build 19041, oder Windows 11. Prüfe deine Version mit winver über das Startmenü. Die aktuelle Microsoft-Anleitung enthält auch die gesonderten Wege für ältere Systeme und weitere Installationsoptionen.

Auf einem verwalteten Firmenrechner können die nötigen Funktionen gesperrt sein. Kläre das mit der Administration. Für die Installation sind Administratorrechte und in der Regel ein Neustart nötig. Sichere offene Arbeit, bevor du beginnst.

WSL mit Ubuntu installieren

Öffne PowerShell über das Startmenü mit „Als Administrator ausführen“. Gib ein:

wsl --install -d Ubuntu

Folge den Meldungen. Wenn ein Neustart verlangt wird, starte Windows neu. Öffne danach Ubuntu über das Startmenü. Beim ersten Start legst du einen Linux-Benutzernamen und ein Passwort an. Das Passwort wird bei der Eingabe nicht als Sternchen angezeigt; das ist normal. Es ist ein Zugang für diese Linux-Umgebung und muss nicht deinem Windows-Passwort entsprechen.

Prüfe anschließend in PowerShell:

wsl --list --verbose

Du solltest die installierte Distribution und ihre WSL-Version sehen. Stopped ist bei einer gerade nicht gestarteten Distribution kein Fehler. Bei einer Neuinstallation ist WSL 2 der vorgesehene Standard. Für abweichende Anzeigen helfen die Microsoft-Befehlsreferenz und die Installationshinweise.

Erst erkennen, dann tippen

Öffne Ubuntu und führe dort aus:

pwd
uname -s

pwd zeigt deinen aktuellen Linux-Ordner, beispielsweise /home/anna. uname -s sollte Linux melden. In Ubuntu verwendest du für Python python3, nicht den Windows-Starter py. Das Installieren von Linux-Paketen geschieht hier über apt:

sudo apt update
sudo apt install python3 python3-venv tmux

sudo verlangt das zuvor angelegte Linux-Passwort. Die Befehle laden Paketinformationen und Programme; führe sie bewusst aus und lies Rückfragen, statt unbekannte Installationsfolgen blind zu bestätigen.

Prüfe die Werkzeuge:

python3 --version
tmux -V

Das Beispielpaket der Serie setzt Python ab Version 3.10 voraus. Steht eine ältere Version in der Ausgabe, verwende eine entsprechend aktuelle Ubuntu-Version beziehungsweise die Windows-Variante der Beispiele. Eine bestehende Arbeitsumgebung musst du dafür nicht vorschnell ersetzen.

Wo liegen meine Dateien?

In Windows sehen Pfade beispielsweise wie C:\Users\Anna\Dokumente aus. In WSL erreichst du dieses Laufwerk üblicherweise unter /mnt/c/Users/Anna/Dokumente. Dein Linux-Benutzerordner liegt dagegen unter /home/anna.

Für Linux-Projekte empfiehlt Microsoft die Ablage im Linux-Dateisystem, wenn du mit Linux-Werkzeugen arbeitest. Lege für die Übung beispielsweise diesen Ordner in Ubuntu an:

mkdir -p ~/ki-serie-test
cd ~/ki-serie-test

Mit dem folgenden Befehl öffnest du den aktuellen WSL-Ordner im Windows-Explorer:

explorer.exe .

Du kannst darüber eine entpackte Kopie des Beispielpakets in den Testordner legen. Öffne für die Skriptaufrufe darin serien/obsidian-und-ki. Die Befehle der Serie beziehen sich auf diesen Serienordner.

Verschiebe nicht gleich deinen einzigen echten Obsidian-Vault. Für den ersten Versuch reicht eine Kopie der erfundenen Umzugsnotizen. Hinweise zu den Dateisystemen stehen in Microsofts Dokumentation zur Dateiverwaltung.

Ein lokaler Probelauf

Wenn du in Ubuntu im Serienordner serien/obsidian-und-ki stehst, versuche:

python3 02-kontext-router/router.py beispiele/umzug "Was ist beim Transport entschieden und was ist offen?"

Die Ausgabe ist Text, den du später einem Chat geben kannst. Das Skript startet kein Modell und sendet keine Anfrage an einen Anbieter. Erscheint „Datei nicht gefunden“, prüfe mit pwd und ls, ob du im richtigen Ordner bist. Installiere nicht deshalb gleich alles neu.

Häufige Fehler gezielt eingrenzen

wsl wird in PowerShell nicht erkannt. Prüfe Windows-Version und den Installationsweg in der Microsoft-Anleitung. Ein Linux-Terminal ersetzt die fehlende Windows-Komponente nicht.

Die Installation meldet fehlende Virtualisierung. WSL 2 benötigt die entsprechende Unterstützung. Microsoft beschreibt die Prüfung von Windows-Funktionen und Firmware-Einstellungen in der WSL-Fehlersuche. Ändere solche Einstellungen anhand der konkreten Meldung und der Anleitung für deinen Rechner.

sudo oder apt wird nicht erkannt. Wahrscheinlich bist du noch in PowerShell. Öffne Ubuntu. Umgekehrt gehören wsl --list --verbose und der Windows-Python-Starter py in dieser Anleitung in PowerShell.

Python läuft, aber ein Paket fehlt. Prüfe, ob du es in Windows oder in WSL installiert hast. Eine virtuelle Python-Umgebung gehört ebenfalls zu der Umgebung, in der sie erstellt wurde. Nutze die passende Anleitung aus dem Beispielpaket.

Eine Sitzung oder Anfrage hängt. Prüfe zuerst die konkrete Anwendung. wsl --shutdown beendet alle laufenden WSL-Distributionen und deren Prozesse; es ist kein harmloses Auffrischen eines einzelnen Fensters. Sichere offene Arbeit, bevor du es bewusst verwendest.

Was als Nächstes sinnvoll ist

Wenn python3 --version und der Router-Test funktionieren, reicht die Einrichtung für die lokalen Beispiele. Gehe zum fünften Serienteil, wenn du einen Assistenten im Terminal ausprobieren möchtest. MCP-Dienste, tmux und weitere Automatisierung ergänzt du erst, wenn du dafür eine konkrete Aufgabe hast.