WSL2 na Windows: Linux w Windows do uruchamiania narzędzi AI

Co to jest WSL2 i po co ono komu z AI

WSL2, czyli Windows Subsystem for Linux w wersji 2, to sposób na uruchomienie prawdziwego Linuxa wewnątrz Windowsa. Nie jest to emulator ani zwykła nakładka na pulpit. Pod spodem działa lekka maszyna wirtualna, a w niej pracuje oficjalne jądro Linuxa, czyli część systemu zarządzająca procesorem, pamięcią i dyskiem. W praktyce piszesz polecenia w oknie terminala, a programy działają tak, jak na zwykłym serwerze z Linuxem.

Porównanie z codziennym życiem: Windows to Twoje mieszkanie, a WSL to osobny pokój z własnym wejściem. Oba mieszczą się w jednym domu i korzystają z tego samego prądu i wody, ale w pokoju możesz ustawić wszystko po swojemu. WSL korzysta z tego samego komputera, ale ma własne pliki, programy i zasady.

Ma to duże znaczenie dla AI, bo większość narzędzi do lokalnych modeli, czyli programów działających na Twoim komputerze bez wysyłania danych do chmury, powstaje z myślą o języku Python i systemie Linux. Instrukcje często zaczynają się od poleceń terminala, a biblioteki do obliczeń na karcie graficznej są przygotowywane przede wszystkim pod Linuxa. Gdy coś nie działa na Windowsie, WSL bywa najprostszą drogą, a nie zmianą całego komputera.

Czego potrzebujesz przed instalacją

Zanim zaczniesz, sprawdź cztery rzeczy. Nie musisz być informatykiem, ale warto mieć je pod ręką, zanim pojawi się pierwszy błąd.

Najważniejsze wymagania przedstawiają się następująco. Każdy punkt sprawdzisz w kilka minut.

• Aktualny Windows. WSL2 wymaga nowszej wersji Windows 10 lub Windows 11. Dokładne wymagania znajdziesz w oficjalnej dokumentacji Microsoft, bo zmieniają się wraz z systemem.
• Konto z uprawnieniami administratora. Instalacja wymaga zgody systemu, a w firmowym komputerze może być zablokowana przez zasady działu IT.
• Karta NVIDIA, jeśli chcesz przyspieszać modele. Jej sterownik instalujesz po stronie Windowsa, pobierając go ze strony producenta. Bez karty WSL także działa, ale modele liczą się na procesorze, co zwykle jest wyraźnie wolniejsze.
• Zapas miejsca na dysku SSD. System Linux i biblioteki zajmują sporo miejsca, a modele AI bywają bardzo duże. Zaplanuj zapas, zanim pobierzesz pierwszy model.

Instalacja WSL2 krok po kroku

Instalacja jest krótka, ale kroki warto wykonać po kolei. Poniżej zarys oparty na ogólnym schemacie, który Microsoft opisuje w dokumentacji. Jeśli polecenia się zmienią, trzymaj się zawsze najnowszej wersji dokumentacji.

Po instalacji dystrybucji Linuxa pamiętaj o jednym: samo WSL instalujesz jednorazowo, ale pakiety Linuxa warto regularnie aktualizować. Robi się to z poziomu terminala, a szczegóły zależą od wybranej dystrybucji.

• Kliknij menu Start, wpisz PowerShell i wybierz uruchomienie jako administrator.
• Wpisz polecenie wsl --install i naciśnij Enter. Program pobierze i zainstaluje składniki WSL oraz domyślną dystrybucję Linuxa.
• Jeśli system o to poprosi, uruchom komputer ponownie. Po restarcie zwykle samo otworzy się okno konfiguracji Linuxa.
• Ustaw nazwę użytkownika i hasło dla Linuxa. To osobne konto, nie musi być takie samo jak konto Windows. Zapisz hasło, bo będzie potrzebne przy poleceniach administratora w Linuxie.
• Sprawdź wersję poleceniem wsl -l -v. Przy zainstalowanej dystrybucji powinna być widoczna wersja 2.

Karta NVIDIA w WSL: sterownik tylko po stronie Windows

To najważniejsza zasada całego poradnika. Sterownik karty graficznej NVIDIA instaluj w Windowsie, pobierając go ze strony producenta. Linux w WSL nie dostaje własnego sterownika karty. Zamiast tego korzysta z tego, który już działa w Windowsie. Dzięki temu programy w Linuxie mogą liczyć na karcie, a Ty nie konfigurujesz sterowników dwa razy.

Ma to znaczenie, bo próba zainstalowania sterownika NVIDIA także w Linuxie, zwłaszcza tego przeznaczonego do zwykłego pulpitu Linuxa, potrafi zepsuć konfigurację i sprawić, że karta przestaje być widoczna. Wtedy szuka się przyczyny godzinami, a rozwiązaniem bywa czysta instalacja w odpowiedniej kolejności.

Sprawdzić połączenie możesz w ten sposób: otwórz terminal Linuxa w WSL i wpisz nvidia-smi. Jeśli program pokaże nazwę karty, jej temperaturę i zużycie pamięci, wszystko działa. Jeśli pojawi się komunikat o braku polecenia albo karta się nie pokaże, wróć do Windowsa i sprawdź, czy sterownik jest aktualny oraz czy karta widoczna jest w Menedżerze urządzeń.

Dla zaawansowanych dochodzi jeszcze zestaw CUDA, czyli biblioteki NVIDIA do obliczeń. Oficjalne instrukcje NVIDIA opisują, jak zainstalować go w WSL bez instalowania sterownika graficznego w Linuxie. Jeśli Twoje narzędzie wymaga konkretnej wersji CUDA, sprawdź ją w dokumentacji tego narzędzia, a nie zgaduj.

Pierwsze narzędzia AI w środowisku Linux

Gdy WSL i karta już działają, większość narzędzi instaluje się w podobny sposób. Zrozumienie tej logiki ułatwi Ci czytanie instrukcji różnych projektów.

Poniższa kolejność działa dla większości programów. Szczegóły, na przykład nazwy pakietów, zawsze sprawdzaj w instrukcji konkretnego projektu.

Wiele programów z interfejsem w przeglądarce działa tak, że uruchamiasz serwer w WSL, a potem otwierasz w przeglądarce Windowsa adres lokalny, zwykle podany w komunikacie programu. Często działa to od razu, a jeśli strona się nie otwiera, sprawdź instrukcję projektu i ustawienia zapory systemu.

Wygodne bywa też edytowanie plików w edytorze Visual Studio Code z rozszerzeniem do pracy z WSL. Edytor widzi wtedy pliki Linuxa, a Ty nie kopiujesz ich tam i z powrotem.

• Zaktualizuj listę pakietów poleceniem sudo apt update, a potem zainstaluj poprawki poleceniem sudo apt upgrade. Te polecenia są typowe dla dystrybucji opartych na Ubuntu, inne mają własne menedżery pakietów.
• Zainstaluj Pythona i narzędzie do środowisk wirtualnych. Nazwy pakietów zależą od wersji, więc sprawdź je w instrukcji projektu.
• Utwórz środowisko wirtualne dla każdego projektu. To osobny folder z własnymi bibliotekami, dzięki czemu jedna aplikacja nie psuje drugiej.
• Zainstaluj narzędzie zgodnie z oficjalną instrukcją projektu i pobierz model ze źródła, które wskazuje autor programu.
• Uruchom program i sprawdź w nvidia-smi, czy karta faktycznie pracuje. Jeśli obciążenie zostaje na procesorze, coś jest źle ustawione.

Pliki, pamięć i dysk: co przyspiesza, a co hamuje

WSL to dwa światy w jednym komputerze, i to na granicy między nimi najczęściej traci się czas. Pliki leżące w katalogach Windowsa, na przykład na dysku C, są widoczne w Linuxie w katalogu mnt, ale odczyt i zapis przez tę granicę bywa wyraźnie wolniejszy. Dotyczy to zwłaszcza tysięcy małych plików, jakie tworzą biblioteki Pythona.

Zasada jest prosta: projekty i modele trzymaj w systemie plików Linuxa, czyli w katalogu domowym w WSL. Do plików Windowsa możesz zajrzeć przez Eksplorator, ale nie pracuj tam na ciężkich modelach.

Ustawienia zasobów WSL zapisuje się w pliku .wslconfig w folderze użytkownika Windowsa. Można tam określić, ile pamięci RAM i procesorów może zużywać Linux. Domyślne wartości zależą od wersji systemu, więc przed zmianą sprawdź je w dokumentacji Microsoft. Zbyt małe ustawienie sprawi, że duże modele się nie zmieszczą, a zbyt duże może utrudnić pracę samemu Windowsowi.

Pamiętaj też o dysku. Wirtualny dysk WSL rośnie wraz z danymi, a usunięcie plików w Linuxie nie zawsze od razu zwalnia miejsce w Windowsie. Przy większej liczbie modeli zaplanuj to z góry. Więcej o dyskach SSD znajdziesz w osobnym poradniku z tego działu.

Zastosowania i ograniczenia

WSL2 z kartą NVIDIA dobrze pasuje do kilku typowych zadań. Poniższe przykłady są ilustracją, nie opisem konkretnych osób czy firm.

Przykładowo właściciel małego sklepu może uruchomić lokalny model językowy, który pomoże pisać opisy produktów, bez wysyłania listy klientów do chmury. Każdy tekst sprawdza przed publikacją. Student uczący się Pythona i bibliotek do AI pracuje na tym samym komputerze, co w Windowsie, bez drugiego systemu. Hobbysta może testować generowanie obrazów i porównywać, jak ten sam model zachowuje się przy różnych ustawieniach.

Ograniczenia są równie ważne. WSL nie jest pełnym, osobnym komputerem. Dzieli z Windowsem procesor, pamięć i kartę graficzną, więc ciężki model zajmuje zasoby także dla innych programów. Pamięć karty graficznej, czyli VRAM, bywa twardym limitem. Jeśli model jest większy, program przerzuci część obliczeń na procesor i odpowiedzi będą wolniejsze albo model się nie uruchomi.

Przy szacowaniu potrzebnej pamięci przyjmij prosty przelicznik jako przybliżenie: liczba miliardów parametrów razy liczba bajtów zapisu na parametr daje rozmiar wag w gigabajtach. Do tego dochodzi zapas na działanie programu. Zapis mniejszymi liczbami bitów, czyli kwantyzacja, zmniejsza wymagania, ale wpływa na jakość odpowiedzi. To tylko szacunek, a wynik zależy od sprzętu, programu i ustawień. Dokładne wartości znajdziesz w opisie konkretnego modelu.

Do tego dochodzą kwestie praktyczne. Interfejs graficzny Linuxa w WSL zależy od wersji Windowsa, a niektóre narzędzia lepiej działają natywnie w Windowsie. Firmowe komputery mogą mieć zablokowane instalacje. WSL to środowisko do nauki i pracy lokalnej, a nie gotowy serwer produkcyjny dla wielu użytkowników.

Bezpieczeństwo, typowe błędy i gdzie sprawdzać aktualne informacje

Lokalne uruchamianie AI daje kontrolę nad danymi, ale nie zwalnia z myślenia. Nie wpisuj do modelu haseł, numerów dokumentów, danych zdrowotnych ani danych klientów, których nie wolno Ci udostępniać. Odpowiedzi AI zawsze sprawdzaj, bo model potrafi podawać nieprawdziwe informacje w pewnym tonie.

Skrypty i modele pobieraj z oficjalnych źródeł, a nie z przypadkowych linków przesyłanych w komunikatorach. Przed uruchomieniem nieznanego kodu przeczytaj, co robi. Przy modelach sprawdzaj też warunki ich użycia, bo licencje bywają różne.

Poniżej typowe błędy, które najczęściej kosztują czas. Przejrzyj tę listę przed pierwszą instalacją i po każdej poważniejszej zmianie.

Aktualne informacje znajdziesz w oficjalnej dokumentacji WSL w serwisie Microsoft Learn. Wpisz w wyszukiwarce frazę dokumentacja WSL Microsoft, a trafisz na aktualne kroki. Sterowniki i CUDA sprawdzisz na stronie NVIDIA, a instrukcje narzędzi w ich oficjalnej dokumentacji. Parametry karty porównuj w opisach producenta, zwracając uwagę na ilość pamięci VRAM. Na allee.pl znajdziesz oferty różnych sprzedawców, ale konkretny model i jego dane zawsze potwierdzaj u producenta, bo opisy w ofertach bywają niepełne.

• Sterownik NVIDIA zainstalowany także w Linuxie, co psuje wykrywanie karty.
• Projekty trzymane w katalogach Windowsa, przez co wszystko działa wolno.
• Brak środowisk wirtualnych i konflikty bibliotek między projektami.
• Zbyt mały limit pamięci w pliku konfiguracyjnym i programy, które nagle się zawieszają.
• Pobieranie modeli z nieznanych źródeł albo bez sprawdzenia warunków ich użycia.
• Ufanie wynikom bez sprawdzenia, zwłaszcza w sprawach zdrowia, prawa i finansów.