Namestitev vmesnika ukazne vrstice Mistral Vibe
Na tej strani
Predpogoji
Preden namestiš Vibe, se prepričaj, da ima tvoj sistem nameščen Python 3.12 ali novejši. To je edina obvezna tehnična odvisnost in hkrati najpogostejši vzrok za napake: številni računalniki z Linuxom še vedno privzeto prihajajo s Pythonom 3.10 ali 3.11. Začni s preverjanjem različice:
python3 --version
# ali na nekaterih sistemih
python --version
Če vidiš različico, nižjo od 3.12, posodobi Python z uradne spletne strani ali prek svojega upravitelja paketov. Ne nadaljuj, dokler tega ne popraviš: namestitev, zagnana na starejši različici, se bo končala z napako pri razreševanju odvisnosti, ki ne kaže na pravi vzrok.
Namestitev na Mac in Linux
Najhitrejša metoda na Macu in Linuxu je urana namestitvena skripta. Potrebuješ le en ukaz:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Ta skripta zazna tvoj sistem, po potrebi namesti uv – izjemno hiter upravitelj paketov za Python – in nato namesti Vibe kot globalno orodje. Ko je postopek končan, je ukaz vibe na voljo v tvojem terminalu.
Alternativa z uv
Če že uporabljaš uv, lahko Vibe namestiš neposredno brez zagona skripte:
uv tool install mistral-vibe
uv samodejno poskrbi za virtualno okolje in odvisnosti. To je prednostna metoda, če delaš na več projektih v Pythonu in se želiš izogniti konfliktom: Vibe živi v svojem izoliranem okolju in nikoli ne bo prepisal različice knjižnice, od katere je odvisen eden tvojih projektov.
Alternativa s pip
Za klasično namestitev prek pip:
pip install mistral-vibe
To deluje, vendar Vibe namesti v trenutno okolje Pythona, kar nosi tveganje za trke. Če naletiš na konflikte odvisnosti, izoliraj orodje v namensko virtualno okolje:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Imej v mislih, da je pri tem pristopu ukaz vibe na voljo le, ko je okolje aktivirano.
Namestitev v sistemu Windows
Windows je podprt, čeprav je Vibe primarno zasnovan za okolja UNIX. Namestitev poteka prek PowerShell v dveh korakih: prvi ukaz namesti uv, drugi pa Vibe.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
Po namestitveni odpri nov terminal, da se ukaz vibe prepozna: trenutna seja PowerShell ohranja staro spremenljivko PATH in bi ti sporočila, da ukaz ne obstaja, čeprav je nameščen.
Windows z WSL
Če uporabljaš WSL (Windows Subsystem for Linux), preprosto sledi navodilom za Mac/Linux. To je pravzaprav priporočena metoda za optimalno izkušnjo v Windowsih, saj so ukazi lupine, ki jih izvaja agent, zasnovani za okolje UNIX:
# V tvojem terminalu WSL
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Preverjanje namestitve
Ne glede na uporabljeno metodo vedno zaključi s preverjanjem. Le tako boš vedel, ali je binarna datoteka res dostopna iz tvoje lupine:
vibe --version
Videti bi moral izpisano številko različice (3.0.4 na dan 2. novembra 2026; generacija 3.0 izvira iz 19. oktobra 2026). Če ukaza ni mogoče najti, to skoraj nikoli ne pomeni, da je namestitev spodletela: pomeni, da imenik namestitve ni v tvoji spremenljivki PATH.
Odpravljanje pogostih težav
Ukaza vibe ni mogoče najti
Po namestitvi prek uv se binarna datoteka običajno nahaja v ~/.local/bin/. Če ta imenik ni naveden v tvoji spremenljivki PATH, ga tvoja lupina ne more videti. Dodaj ga v svojo konfiguracijsko datoteko:
# V ~/.bashrc ali ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
Nato ponovno naloži lupino, da sprememba začne veljati v trenutni seji:
source ~/.bashrc
# ali
source ~/.zshrc
Napaka predpomnilnika z uv
Včasih prejšnja namestitev pusti poškodovan predpomnilnik, običajno po prekinitvi omrežne povezave. Namestitev se nato konča z napako, ki omenja predpomnilnik. Ponovno zaženi ukaz z obidom predpomnilnika:
uv tool install mistral-vibe --no-cache
Konflikt različice Pythona
Na računalniku, kjer sobiva več tolmačev – na primer sistemski Python 3.11 in ročno nameščen 3.12 – lahko uv izbere napačnega. Izrecno vsili ciljno različico:
uv tool install mistral-vibe --python python3.12
Te tri situacije pokrivajo skoraj vse primere, ko se namestitev zatakne. Naj ti bo v navadi, da po vsakem popravku ponovno zaženeš vibe --version.
Ključne ugotovitve
- Python 3.12+ je edini tehnični predpogoj
- Na Macu/Linuxu je skripta
curlnajhitrejša metoda uv tool installje priporočena metoda za izogibanje konfliktom- V Windowsih za boljšo izkušnjo raje uporabi WSL
- Namestitev preveri z ukazom
vibe --version