Instalacja Mistral Vibe CLI
Na tej stronie
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
curljest najszybszą metodą uv tool installto zalecana metoda unikania konfliktów- Na Windows preferuj WSL dla lepszego doświadczenia
- Zweryfikuj instalację poleceniem
vibe --version