Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Instalacija Mistral Vibe CLI-ja

Lekcija 2 od 16 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Preduvjeti
  2. Instalacija na Macu i Linuxu
  3. Instalacija na Windowsima
  4. Provjera instalacije
  5. Rješavanje uobičajenih problema
  6. Ključne točke

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 curl najbrža je metoda
  • uv tool install preporučena je metoda za izbjegavanje sukoba
  • Na Windowsima, za bolje iskustvo preferiraj WSL
  • Provjeri instalaciju s vibe --version