Instalacija Mistral Vibe CLI-ja
Na ovoj stranici
Preduvjeti
Prije instalacije alata Vibe, provjeri imaš li na sustavu Python 3.12 ili noviji. To je jedina obavezna tehnička ovisnost, a ujedno i najčešći uzrok neuspjeha: mnogi Linux strojevi prema zadanim postavkama još uvijek dolaze s Pythonom 3.10 ili 3.11. Započni provjerom svoje verzije:
python3 --version
# ili na nekim sustavima
python --version
Ako vidiš verziju nižu od 3.12, ažuriraj Python sa službene web-stranice ili putem upravitelja paketa. Nemoj nastaviti dok to ne riješiš: instalacija pokrenuta na starijoj verziji završit će pogreškom razrješavanja ovisnosti koja ne ukazuje na pravi uzrok.
Instalacija na Macu i Linuxu
Najbrža metoda na Macu i Linuxu jest službena instalacijska skripta. Dovoljna je jedna naredba:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Ova skripta detektira tvoj sustav, instalira uv—ultrabrz upravitelj Python paketa—ako je potrebno, a zatim instalira Vibe kao globalni alat. Po završetku, naredba vibe dostupna je u tvom terminalu.
Alternativa s uv-om
Ako već koristiš uv, možeš instalirati Vibe izravno bez pokretanja skripte:
uv tool install mistral-vibe
uv automatski upravlja virtualnim okruženjem i ovisnostima. Ovo je preferirana metoda ako radiš na više Python projekata i želiš izbjeći sukobe: Vibe živi u vlastitom izoliranom okruženju i nikada neće prepisati verziju biblioteke od koje ovisi neki tvoj projekt.
Alternativa s pip-om
Za klasičnu instalaciju putem pipa:
pip install mistral-vibe
Ovo funkcionira, ali instalira Vibe u trenutno Python okruženje, što nosi rizik od sukoba. Ako naiđeš na sukobe ovisnosti, izoliraj alat u namjensko virtualno okruženje:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Imaj na umu da je s ovim pristupom naredba vibe dostupna samo dok je okruženje aktivirano.
Instalacija na Windowsima
Windowsi su podržani, iako je Vibe prvenstveno dizajniran za UNIX okruženja. Instalacija se odvija putem PowerShell-a u dva koraka: prva naredba instalira uv, a druga instalira Vibe.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
Nakon instalacije otvori novi terminal kako bi se naredba vibe prepoznala: trenutna PowerShell sesija zadržava staru varijablu PATH i javit će ti da naredba ne postoji, iako je instalirana.
Windowsi s WSL-om
Ako koristiš WSL (Windows Subsystem for Linux), jednostavno slijedi upute za Mac/Linux. Ovo je zapravo preporučena metoda za optimalno iskustvo na Windowsima jer su naredbe ljuske koje agent izvršava dizajnirane za UNIX okruženje:
# U tvom WSL terminalu
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Provjera instalacije
Bez obzira na korištenu metodu, uvijek završi provjerom. To je jedini način da saznaš je li binarna datoteka doista dostupna iz tvoje ljuske:
vibe --version
Trebao/la bi vidjeti ispisani broj verzije (3.0.4 na dan 2. studenoga 2026.; generacija 3.0 datira od 19. listopada 2026.). Ako naredba nije pronađena, to gotovo nikada ne znači da je instalacija neuspjela: to znači da direktorij instalacije nije u tvom PATH-u.
Rješavanje uobičajenih problema
Naredba vibe nije pronađena
Nakon instalacije putem uv, binarna datoteka se obično nalazi u ~/.local/bin/. Ako taj direktorij nije deklariran u tvom PATH-u, tvoja ljuska ga ne može vidjeti. Dodaj ga u svoju konfiguracijsku datoteku:
# U ~/.bashrc ili ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
Zatim ponovno učitaj ljusku kako bi promjena stupila na snagu u trenutnoj sesiji:
source ~/.bashrc
# ili
source ~/.zshrc
Pogreška predmemorije (cache) s uv-om
Ponekad prethodna instalacija ostavi oštećenu predmemoriju, obično nakon prekida mreže. Instalacija tada ne uspije s pogreškom koja spominje predmemoriju. Ponovno pokreni naredbu zaobilazeći je:
uv tool install mistral-vibe --no-cache
Sukob verzije Pythona
Na stroju gdje koegzistiraju više interpretera—npr. sistemski Python 3.11 i ručno instalirani 3.12—uv bi mogao odabrati pogrešan. Eksplicitno prisili ciljanu verziju:
uv tool install mistral-vibe --python python3.12
Ove tri situacije pokrivaju gotovo sve zaglavljene instalacije. Uzmi si u naviku ponovno pokrenuti vibe --version nakon svakog popravka.
Ključne točke
- Python 3.12+ jedini je tehnički preduvjet
- Na Macu/Linuxu, skripta s
curlnajbrža je metoda uv tool installpreporučena je metoda za izbjegavanje sukoba- Na Windowsima, za bolje iskustvo preferiraj WSL
- Provjeri instalaciju s
vibe --version