Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Mistral Vibe CLI installimine

Õppetund 2 / 16 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Eeltingimused
  2. Installimine Macis ja Linuxis
  3. Installimine Windowsis
  4. Installimise kontrollimine
  5. Levinud probleemide tõrkeotsing
  6. Peamised punktid

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 install on soovitatud meetod konfliktide vältimiseks
  • Windowsis eelista parema kogemuse saamiseks WSL-i
  • Kontrolli installimist käsuga vibe --version