Įdiegti Mistral Vibe CLI
Šiame puslapyje
Būtinos sąlygos
Prieš diegdami „Vibe“, įsitikinkite, kad jūsų sistemoje yra Python 3.12 arba naujesnė versija. Tai vienintelė privaloma techninė priklausomybė ir dažniausia nesėkmių priežastis: daugelyje „Linux“ kompiuterių pagal nutylėjimą vis dar diegiama „Python 3.10“ arba „3.11“. Pradėkite patikrindami savo versiją:
python3 --version
# arba kai kuriose sistemose
python --version
Jei matote versiją, žemesnę nei 3.12, atnaujinkite „Python“ iš oficialios svetainės arba naudodami savo paketų tvarkyklę. Netęskite, kol šios problemos neišspręsite: diegimas, paleistas senesne versija, žlunga dėl priklausomybių išsprendimo klaidos, kuri nenurodo tikrosios priežasties.
Diegimas „Mac“ ir „Linux“ sistemose
Greičiausias būdas „Mac“ ir „Linux“ sistemose – naudoti oficialų diegimo scenarijų. Tam pakanka vienos komandos:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Šis scenarijus aptinka jūsų sistemą, prireikus įdiegia uv – itin greitą „Python“ paketų tvarkyklę – ir tada įdiegia „Vibe“ kaip globalų įrankį. Baigus darbą, terminale bus pasiekiama vibe komanda.
Alternatyva naudojant „uv“
Jei jau naudojate uv, galite įdiegti „Vibe“ tiesiogiai, nenaudodami scenarijaus:
uv tool install mistral-vibe
uv automatiškai valdo virtualiąją aplinką ir priklausomybes. Tai pageidaujamas būdas, jei dirbate su keliais „Python“ projektais ir norite išvengti konfliktų: „Vibe“ veikia savo izoliuotoje aplinkoje ir niekada neperrašys bibliotekos versijos, nuo kurios priklauso kuris nors jūsų projektas.
Alternatyva naudojant „pip“
Klasikiniam diegimui per „pip“:
pip install mistral-vibe
Tai veikia, tačiau „Vibe“ įdiegiama į dabartinę „Python“ aplinką, o tai kelia susidūrimų riziką. Jei susidursite su priklausomybių konfliktais, izoliuokite įrankį atskiroje virtualiojoje aplinkoje:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Atminkite, kad taikant šį metodą, vibe komanda pasiekiama tik tada, kai aplinka yra aktyvuota.
Diegimas „Windows“ sistemose
„Windows“ yra palaikoma, nors „Vibe“ pirmiausia skirta UNIX aplinkoms. Diegimas atliekamas per „PowerShell“ dviem etapais: pirmoji komanda įdiegia uv, antroji – „Vibe“.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
Po diegimo atidarykite naują terminalą, kad vibe komanda būtų atpažinta: dabartinė „PowerShell“ sesija išlaiko senąjį PATH ir praneštų, kad komanda neegzistuoja, nors ji jau yra įdiegta.
„Windows“ su WSL
Jei naudojate WSL („Windows Subsystem for Linux“), tiesiog vadovaukitės „Mac“/„Linux“ instrukcijomis. Tai iš tikrųjų yra rekomenduojamas būdas optimaliam darbui „Windows“ sistemoje, nes agento vykdomos apvalkalo komandos sukurtos UNIX aplinkai:
# Jūsų WSL terminale
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Diegimo patikrinimas
Nepriklausomai nuo naudoto metodo, visada baigkite patikrinimu. Tai vienintelis būdas sužinoti, ar dvejetainis failas iš tikrųjų pasiekiamas iš jūsų apvalkalo:
vibe --version
Turėtumėte pamatyti rodomą versijos numerį (3.0.4 pagal 2026 m. lapkričio 2 d. duomenis; 3.0 kartos išleidimo data – 2026 m. spalio 19 d.). Jei komanda nerandama, tai beveik niekada nereiškia, kad diegimas nepavyko: tai reiškia, kad diegimo katalogas nėra jūsų PATH.
Dažniausiai pasitaikančių problemų šalinimas
Komanda vibe nerandama
Įdiegus per uv, dvejetainis failas paprastai yra aplanke ~/.local/bin/. Jei šis aplankas nenurodytas jūsų PATH, jūsų apvalkalas jo nemato. Pridėkite jį prie konfigūracijos failo:
# Faile ~/.bashrc arba ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
Tada iš naujo įkelkite apvalkalą, kad pakeitimai įsigaliotų dabartinėje sesijoje:
source ~/.bashrc
# arba
source ~/.zshrc
Talpyklos klaida naudojant „uv“
Kartais ankstesnis diegimas palieka sugadintą talpyklą, dažniausiai po tinklo sutrikimo. Tuomet diegimas žlunga su klaida, mininčia talpyklą. Paleiskite komandą iš naujo, apeidami talpyklą:
uv tool install mistral-vibe --no-cache
„Python“ versijos konfliktas
Kompiuteryje, kuriame vienu metu veikia kelios interpretatorių versijos (pavyzdžiui, sisteminė „Python 3.11“ ir rankiniu būdu įdiegta „3.12“), uv gali pasirinkti netinkamą. Aiškiai priverskite naudoti norimą versiją:
uv tool install mistral-vibe --python python3.12
Šios trys situacijos apima beveik visas užstrigusias diegimo procedūras. Įpraskite po kiekvieno taisymo iš naujo paleisti vibe --version.
Svarbiausi punktai
- „Python 3.12+“ yra vienintelė techninė būtina sąlyga
- „Mac“/„Linux“ sistemose
curlscenarijus yra greičiausias būdas uv tool installyra rekomenduojamas būdas išvengti konfliktų- „Windows“ sistemoje geresnei patirčiai rinkitės WSL
- Patikrinkite diegimą naudodami
vibe --version