Przejdź do głównej treści
Polski— Wybierz język
Menu

Instalacja Mistral Vibe CLI

Lekcja 2 z 16 Zaktualizowano 2 listopada 2026 Programista
Na tej stronie
  1. Wymagania wstępne
  2. Instalacja na Mac i Linux
  3. Instalacja na Windows
  4. Weryfikacja instalacji
  5. Rozwiązywanie typowych problemów
  6. Kluczowe wnioski

Wymagania wstępne

Zanim zainstalujesz Vibe, upewnij się, że Twój system ma Pythona w wersji 3.12 lub nowszej. To jedyne obowiązkowe wymaganie techniczne, a jednocześnie najczęstsza przyczyna niepowodzeń: wiele dystrybucji Linuksa nadal domyślnie dostarcza Pythona 3.10 lub 3.11. Zacznij od sprawdzenia swojej wersji:

python3 --version
# lub na niektórych systemach
python --version

Jeśli widzisz wersję niższą niż 3.12, zaktualizuj Pythona ze strony oficjalnej lub za pomocą menedżera pakietów. Nie kontynuuj, dopóki tego nie naprawisz: instalacja uruchomiona na starszej wersji zakończy się błędem rozwiązywania zależności, który nie wskaże prawdziwej przyczyny.

Instalacja na Mac i Linux

Najszybszą metodą na Macu i Linuksie jest oficjalny skrypt instalacyjny. Wystarczy jedno polecenie:

curl -LsSf https://mistral.ai/vibe/install.sh | bash

Skrypt ten wykrywa Twój system, instaluje uv – ultraszybki menedżer pakietów Pythona – jeśli to konieczne, a następnie instaluje Vibe jako narzędzie globalne. Po zakończeniu polecenie vibe będzie dostępne w Twoim terminalu.

Alternatywa z użyciem uv

Jeśli już używasz uv, możesz zainstalować Vibe bezpośrednio bez uruchamiania skryptu:

uv tool install mistral-vibe

uv automatycznie zarządza wirtualnym środowiskiem i zależnościami. To preferowana metoda, jeśli pracujesz nad wieloma projektami w Pythonie i chcesz uniknąć konfliktów: Vibe działa we własnym, izolowanym środowisku i nigdy nie nadpisze wersji biblioteki, od której zależy któryś z Twoich projektów.

Alternatywa z użyciem pip

W przypadku klasycznej instalacji przez pip:

pip install mistral-vibe

To działa, ale instaluje Vibe w bieżącym środowisku Pythona, co niesie ryzyko kolizji. Jeśli napotkasz konflikty zależności, odizoluj narzędzie w dedykowanym środowisku wirtualnym:

python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe

Pamiętaj, że przy tym podejściu polecenie vibe jest dostępne tylko wtedy, gdy środowisko jest aktywowane.

Instalacja na Windows

Windows jest obsługiwany, choć Vibe został zaprojektowany głównie z myślą o środowiskach UNIX. Instalacja odbywa się w PowerShellu w dwóch krokach: pierwsze polecenie instaluje uv, a drugie instaluje Vibe.

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe

Po instalacji otwórz nowy terminal, aby polecenie vibe zostało rozpoznane: bieżąca sesja PowerShell zachowuje starą zmienną PATH i może zgłosić, że polecenie nie istnieje, mimo że zostało zainstalowane.

Windows z WSL

Jeśli używasz WSL (Podsystem Windows dla Linuxa), po prostu postępuj zgodnie z instrukcjami dla Mac/Linux. Jest to właściwie zalecana metoda, aby uzyskać optymalne doświadczenie na Windowsie, ponieważ polecenia powłoki wykonywane przez agenta są zaprojektowane dla środowiska UNIX:

# W terminalu WSL
curl -LsSf https://mistral.ai/vibe/install.sh | bash

Weryfikacja instalacji

Niezależnie od użytej metody, zawsze zakończ proces weryfikacją. To jedyny sposób, aby upewnić się, że plik binarny jest naprawdę dostępny z poziomu powłoki:

vibe --version

Powinieneś zobaczyć wyświetlony numer wersji (3.0.4 według stanu na 2 listopada 2026 r.; generacja 3.0 pochodzi z 19 października 2026 r.). Jeśli polecenie nie zostanie znalezione, prawie nigdy nie oznacza to nieudanej instalacji: oznacza to, że katalog instalacyjny nie znajduje się w Twojej zmiennej PATH.

Rozwiązywanie typowych problemów

Polecenie vibe nie zostało znalezione

Po instalacji przez uv plik binarny znajduje się zazwyczaj w ~/.local/bin/. Jeśli ten katalog nie jest zadeklarowany w zmiennej PATH, Twoja powłoka go nie widzi. Dodaj go do pliku konfiguracyjnego:

# W ~/.bashrc lub ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"

Następnie przeładuj powłokę, aby zmiany zaczęły obowiązywać w bieżącej sesji:

source ~/.bashrc
# lub
source ~/.zshrc

Błąd pamięci podręcznej z uv

Czasami poprzednia instalacja pozostawia uszkodzoną pamięć podręczną, zazwyczaj po przerwaniu połączenia sieciowego. Instalacja kończy się wtedy błędem wskazującym na pamięć podręczną. Uruchom ponownie polecenie, pomijając ją:

uv tool install mistral-vibe --no-cache

Konflikt wersji Pythona

Na maszynie, gdzie współistnieje wiele interpreterów – np. systemowy Python 3.11 i ręcznie zainstalowany 3.12 – uv może wybrać niewłaściwy. Wymuś wyraźnie docelową wersję:

uv tool install mistral-vibe --python python3.12

Te trzy sytuacje obejmują niemal wszystkie przypadki zawieszonych instalacji. Wyrobij sobie nawyk ponownego uruchamiania vibe --version po każdej naprawie.

Kluczowe wnioski

  • Python 3.12+ to jedyne techniczne wymaganie wstępne
  • Na Mac/Linux skrypt curl jest najszybszą metodą
  • uv tool install to zalecana metoda unikania konfliktów
  • Na Windows preferuj WSL dla lepszego doświadczenia
  • Zweryfikuj instalację poleceniem vibe --version