Installazzjoni tal-Mistral Vibe CLI
F'din il-paġna
Prerekwiżiti
Qabel ma tinstalla l-Vibe, żgura li s-sistema tiegħek għandha Python 3.12 jew ogħla. Din hija l-unika dipendenza teknika obbligatorja, u hija wkoll l-aktar sors komuni ta’ falliment: ħafna magni Linux għadhom jiġu b’Python 3.10 jew 3.11 b’mod predefinit. Ibda billi tiċċekkja l-verżjoni tiegħek:
python3 --version
# or on some systems
python --version
Jekk tara verżjoni inferjuri għal 3.12, aġġorna Python mis-sit uffiċjali jew permezz tal-maniġer tal-pakketti tiegħek. Tipproċedix qabel ma ssolvi dan: installazzjoni mnedija fuq verżjoni antika tfalli b’żball fir-riżoluzzjoni tad-dipendenzi li ma jindikax il-kawża reali.
Installazzjoni fuq Mac u Linux
L-aktar metodu veloċi fuq Mac u Linux huwa l-iskritt ta’ installazzjoni uffiċjali. Kmand wieħed biss huwa biżżejjed:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Dan l-iskritt jiskopri s-sistema tiegħek, jinstalla uv—il-maniġer tal-pakketti Python ultra-veloċi—jekk ikun meħtieġ, u mbagħad jinstalla l-Vibe bħala għodda globali. Ladarba jintemm, il-kmand vibe ikun disponibbli fit-terminal tiegħek.
Alternattiva b’uv
Jekk diġà tuża uv, tista’ tinstalla l-Vibe direttament mingħajr ma tħaddem l-iskritt:
uv tool install mistral-vibe
uv jimmaniġġja awtomatikament l-ambjent virtwali u d-dipendenzi. Dan huwa l-metodu ppreferut jekk taħdem fuq proġetti Python multipli u trid tevita kunflitti: il-Vibe jgħix fl-ambjent iżolat tiegħu stess u qatt mhu se jissostitwixxi verżjoni ta’ librerija li wieħed mill-proġetti tiegħek jiddependi fuqha.
Alternattiva b’pip
Għal installazzjoni klassika permezz ta’ pip:
pip install mistral-vibe
Dan jaħdem, iżda jinstalla l-Vibe fl-ambjent Python attwali, u jġorr ir-riskju ta’ kolliżjonijiet. Jekk tiltaqa’ ma’ kunflitti fid-dipendenzi, iżola l-għodda f’ambjent virtwali ddedikat:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Żomm f’moħħok li b’dan l-approċċ, il-kmand vibe ikun disponibbli biss meta l-ambjent ikun attivat.
Installazzjoni fuq Windows
Windows huwa appoġġjat, għalkemm il-Vibe huwa ddisinjat primarjament għal ambjenti UNIX. L-installazzjoni ssir permezz ta’ PowerShell f’żewġ passi: l-ewwel kmand jinstalla uv, u t-tieni jinstalla l-Vibe.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
Wara l-installazzjoni, iftaħ terminal ġdid biex il-kmand vibe jiġi rikonoxxut: is-sessjoni attwali ta’ PowerShell iżżomm il-PATH antik u tgħidlek li l-kmand ma jeżistix, anke jekk huwa installat.
Windows b’WSL
Jekk tuża WSL (Windows Subsystem for Linux), sempliċiment segwi l-istruzzjonijiet għal Mac/Linux. Dan huwa attwalment il-metodu rrakkomandat għal esperjenza ottimali fuq Windows, għax il-kmands tal-qoxra li l-aġent jesegwixxi huma ddisinjati għal ambjent UNIX:
# In your WSL terminal
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Ivvjerifika l-Installazzjoni
Irrispettivament mill-metodu użat, dejjem temma b’verifika. Din hija l-unika manera biex tkun taf jekk il-binary huwiex verament aċċessibbli mill-qoxra tiegħek:
vibe --version
Għandek tara n-numru tal-verżjoni muri (3.0.4 sal-2 ta’ Novembru 2026; il-ġenerazzjoni 3.0 tmur lura għad-19 ta’ Ottubru 2026). Jekk il-kmand ma jinstabx, kważi qatt mhux minħabba li l-installazzjoni falliet: ifisser li d-direttorju tal-installazzjoni mhuwiex fil-PATH tiegħek.
Soluzzjoni ta’ Problemi Komuni
Il-kmand vibe ma jinstabx
Wara l-installazzjoni permezz ta’ uv, il-binary ġeneralment jinsab f’~/.local/bin/. Jekk dan id-direttorju mhux iddikjarat fil-PATH tiegħek, il-qoxra tiegħek ma tistax tarah. Żidhu mal-fajl tal-konfigurazzjoni tiegħek:
# In ~/.bashrc or ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
Imbagħad erġa’ ħarreġ il-qoxra tiegħek biex il-bidla tidħol fis-seħħ fis-sessjoni attwali:
source ~/.bashrc
# or
source ~/.zshrc
Żball fil-cache ma’ uv
Xi kultant installazzjoni preċedenti tħalli cache korrott, tipikament wara interruzzjoni fin-netwerk. L-installazzjoni mbagħad tfalli b’żball li jsemmi l-cache. Erġa’ ħaddem il-kmand billi tevitah:
uv tool install mistral-vibe --no-cache
Kunflitt fil-verżjoni ta’ Python
Fuq magna fejn jikkoegżistu interpreturi multipli—Python 3.11 tas-sistema u 3.12 installat manwalment, pereżempju—uv jista’ jagħżel dak ħażin. Furza espliċitament il-verżjoni fil-mira:
uv tool install mistral-vibe --python python3.12
Dawn it-tliet sitwazzjonijiet ikopru kważi l-installazzjonijiet imblukkati kollha. Agħmilha drawwa li terġa’ tħaddem vibe --version wara kull fix.
Punti Ewlenin
- Python 3.12+ huwa l-uniku prerekwiżit tekniku
- Fuq Mac/Linux, l-iskritt
curlhuwa l-aktar metodu veloċi uv tool installhuwa l-metodu rrakkomandat biex jiġu evitati kunflitti- Fuq Windows, ippreferi WSL għal esperjenza aħjar
- Ivvjerifika l-installazzjoni b’
vibe --version