Asenna Mistral Vibe CLI
Tällä sivulla
Edellytykset
Ennen Viben asentamista varmista, että järjestelmässäsi on Python 3.12 tai uudempi. Tämä on ainoa pakollinen tekninen riippuvuus, ja se on myös yleisin epäonnistumisen syy: monet Linux-koneet toimitetaan edelleen oletusarvoisesti Python 3.10:n tai 3.11:n kanssa. Aloita tarkistamalla versiosi:
python3 --version
# tai joissakin järjestelmissä
python --version
Jos näet versiota, joka on alempi kuin 3.12, päivitä Python viralliselta verkkosivustolta tai paketinhallintajärjestelmäsi kautta. Älä jatka ennen kuin olet korjannut tämän: vanhemmalle versiolle suoritetun asennuksen epäonnistuminen johtaa riippuvuuksien ratkaisuvirheeseen, joka ei kerro todellista syytä.
Asennus Mac- ja Linux-järjestelmiin
Nopein tapa Macissa ja Linuxissa on virallinen asennuskomentosarja. Tarvitset vain yhden komennon:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Tämä komentosarja tunnistaa järjestelmäsi, asentaa uv:n – erittäin nopean Python-paketinhallinnan – tarvittaessa ja asentaa sitten Viben globaalina työkaluna. Valmistuttuaan vibe-komento on käytettävissä päätelaitteessasi.
Vaihtoehto uv:n avulla
Jos käytät jo uv:tä, voit asentaa Viben suoraan ajamatta komentosarjaa:
uv tool install mistral-vibe
uv hallitsee automaattisesti virtuaaliympäristön ja riippuvuudet. Tämä on suositeltu menetelmä, jos työskentelet useiden Python-projektien parissa ja haluat välttää ristiriidat: Vibe elää omassa eristetyssä ympäristössään eikä koskaan ylikirjoita kirjastoversiota, johon jokin projekteistasi luottaa.
Vaihtoehto pip:n avulla
Klassiseen asennukseen pip:n kautta:
pip install mistral-vibe
Tämä toimii, mutta se asentaa Viben nykyiseen Python-ympäristöön, mikä tuo mukanaan törmäysriskin. Jos kohtaat riippuvuusristiriitoja, eristä työkalu omistettuun virtuaaliympäristöön:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Pidä mielessäsi, että tällä lähestymistavalla vibe-komento on käytettävissä vain, kun ympäristö on aktivoitu.
Asennus Windowsiin
Windowsia tuetaan, vaikka Vibe on ensisijaisesti suunniteltu UNIX-ympäristöille. Asennus tapahtuu PowerShellin kautta kahdessa vaiheessa: ensimmäinen komento asentaa uv:n ja toinen asentaa Viben.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
Asennuksen jälkeen avaa uusi pääteikkuna, jotta vibe-komento tunnistetaan: nykyinen PowerShell-istunto säilyttää vanhan PATH:n ja ilmoittaisi komennon puuttuvan, vaikka se olisi asennettu.
Windows WSL:llä
Jos käytät WSL:ää (Windows Subsystem for Linux), seuraa yksinkertaisesti Mac/Linux-ohjeita. Tämä on itse asiassa suositeltu menetelmä optimaalisen kokemuksen saavuttamiseksi Windowsissa, koska agentin suorittamat shell-komennot on suunniteltu UNIX-ympäristöön:
# WSL-päätteessäsi
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Asennuksen vahvistaminen
Käytetystä menetelmästä riippumatta viimeistele aina vahvistuksella. Tämä on ainoa tapa tietää, onko binääritiedosto todella käytettävissä shellistäsi:
vibe --version
Näet versionumeron näytöllä (3.0.4 päivämäärällä 2. marraskuuta 2026; sukupolvi 3.0 on peräisin 19. lokakuuta 2026). Jos komentoa ei löydy, syynä ei lähes koskaan ole epäonnistunut asennus: se tarkoittaa, että asennushakemistoa ei ole lisätty PATH:iisi.
Yleisten ongelmien vianmääritys
Komentoa vibe ei löydy
uv:n kautta tehdyn asennuksen jälkeen binääritiedosto sijaitsee yleensä hakemistossa ~/.local/bin/. Jos tätä hakemistoa ei ole määritelty PATH:ssasi, shellisi ei näe sitä. Lisää se määritystiedostoosi:
# Tiedostossa ~/.bashrc tai ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
Lataa sitten shellisi uudelleen, jotta muutos tulee voimaan nykyisessä istunnossa:
source ~/.bashrc
# tai
source ~/.zshrc
Välimuistivirhe uv:n kanssa
Joskus aiempi asennus jättää vioittuneen välimuistin, tyypillisesti verkkokatkoksen jälkeen. Asennus epäonnistuu tällöin virheellä, joka viittaa välimuistiin. Suorita komento uudelleen ohittaen välimuisti:
uv tool install mistral-vibe --no-cache
Python-version ristiriita
Koneella, jossa useita tulkkeja on rinnakkain – esimerkiksi järjestelmän Python 3.11 ja manuaalisesti asennettu 3.12 – uv saattaa valita väärän. Pakota kohdeversio nimenomaisesti:
uv tool install mistral-vibe --python python3.12
Nämä kolme tilannetta kattavat lähes kaikki jumittuneet asennukset. Tee tavaksi suorittaa vibe --version uudelleen jokaisen korjauksen jälkeen.
Keskeiset asiat
- Python 3.12+ on ainoa tekninen edellytys
- Mac/Linuxissa
curl-komentosarja on nopein menetelmä uv tool installon suositeltu menetelmä ristiriitojen välttämiseksi- Windowsissa suosittu WSL paremman kokemuksen saavuttamiseksi
- Vahvista asennus komennolla
vibe --version