Mistral Vibe CLI installimine
Sellel lehel
Eeltingimused
Enne Vibe’i installimist veendu, et sinu süsteemis on Python 3.12 või uuem. See on ainus kohustuslik tehniline sõltuvus ja ühtlasi kõige levinum tõrkeallikas: paljud Linuxi masinad kasutavad vaikimisi endiselt Python 3.10 või 3.11. Alusta versiooni kontrollimisest:
python3 --version
# või mõnel süsteemil
python --version
Kui näed versiooni, mis on madalam kui 3.12, uuenda Python ametlikult veebisaidilt või oma paketihalduri kaudu. Ära jätkata, enne kui selle probleemi lahendad: vanemale versioonile tehtud installimine ebaõnnestub sõltuvuste lahendamise veaga, mis ei osuta tegelikule põhjusele.
Installimine Macis ja Linuxis
Kiireim viis Macis ja Linuxis on ametlik installimisskript. Sul on vaja ainult ühte käsku:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
See skript tuvastab sinu süsteemi, installib vajadusel uv – ülikiire Pythoni paketihalduri – ja seejärel paigaldab Vibe’i globaalse tööriistana. Pärast lõpetamist on käsk vibe sinu terminalis saadaval.
Alternatiiv uv-ga
Kui kasutad juba uv, saad Vibe’i installida otse, ilma skripti käivitamata:
uv tool install mistral-vibe
uv haldab automaatselt virtuaalset keskkonda ja sõltuvusi. See on eelistatud meetod, kui töötad mitme Pythoni projektiga ja soovid vältida konflikte: Vibe elab oma isoleeritud keskkonnas ja ei kirjuta kunagi üle teegi versiooni, millest mõni sinu projekt sõltub.
Alternatiiv pip-iga
Klassikaliseks installimiseks pip-i kaudu:
pip install mistral-vibe
See toimib, kuid installib Vibe’i praegusesse Pythoni keskkonda, mis toob kaasa kokkupõrgete riski. Kui tekivad sõltuvuskonfliktid, isoleeri tööriist pühendatud virtuaalses keskkonnas:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Pea meeles, et selle lähenemisviisi korral on käsk vibe saadaval ainult siis, kui keskkond on aktiveeritud.
Installimine Windowsis
Windows on toetatud, kuigi Vibe on peamiselt loodud UNIX-i keskkondade jaoks. Installimine toimub PowerShellis kahes etapis: esimene käsk installib uv ja teine Vibe’i.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
Pärast installimist ava uus terminal, et käsk vibe ära tuntaks: praegune PowerShelli seanss säilitab vana PATH ja teataks, et käsku ei eksisteeri, kuigi see on tegelikult installitud.
Windows koos WSL-iga
Kui kasutad WSL-i (Windows Subsystem for Linux), järgi lihtsalt Maci/Linuxi juhiseid. See on tegelikult soovitatud meetod optimaalseks kasutuskogemuseks Windowsis, sest käsud, mida agent käivitab, on mõeldud UNIX-i keskkonnale:
# Sinu WSL terminalis
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Installimise kontrollimine
Sõltumata kasutatud meetodist, lõpeta alati kontrollimisega. See on ainus viis teada saada, kas binaarfail on sinu shellist tegelikult kättesaadav:
vibe --version
Sa peaksid nägema kuvatud versiooninumbrit (3.0.4 seisuga 2. november 2026; 3.0 põlvkond pärineb 19. oktoobrist 2026). Kui käsku ei leita, pole põhjus peaaegu kunagi installimise ebaõnnestumine: see tähendab, et installimiskataloog ei ole sinu PATH-is.
Levinud probleemide tõrkeotsing
Käsku vibe ei leita
Pärast uv kaudu installimist asub binaarfail tavaliselt kataloogis ~/.local/bin/. Kui seda kataloogi pole PATH-is deklareeritud, ei näe sinu shell seda. Lisa see oma konfiguratsioonifaili:
# Failis ~/.bashrc või ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
Seejärel laadi shell uuesti, et muudatus jõustuks praeguses seansis:
source ~/.bashrc
# või
source ~/.zshrc
Vahemälu viga uv-ga
Mõnikord jätab eelmine installimine rikutud vahemälu, tavaliselt pärast võrgukatkestust. Sellisel juhul ebaõnnestub installimine veateatega, mis viitab vahemälule. Käivita käsk uuesti, möödudes vahemälust:
uv tool install mistral-vibe --no-cache
Pythoni versiooni konflikt
Masinal, kus eksisteerib kõrvuti mitu interpreterit – näiteks süsteemi Python 3.11 ja käsitsi installitud 3.12 –, võib uv valida vale. Sunni sihtversioon otseselt:
uv tool install mistral-vibe --python python3.12
Need kolm olukorda katavad peaaegu kõik takerdunud installimised. Harjumuseks peaks saama käsu vibe --version uuesti käivitamine pärast iga parandust.
Peamised punktid
- Python 3.12+ on ainus tehniline eeltingimus
- Macis/Linuxis on
curl-i skript kiireim meetod uv tool installon soovitatud meetod konfliktide vältimiseks- Windowsis eelista parema kogemuse saamiseks WSL-i
- Kontrolli installimist käsuga
vibe --version