Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Installazzjoni tal-Mistral Vibe CLI

Lezzjoni 2 / 16 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Prerekwiżiti
  2. Installazzjoni fuq Mac u Linux
  3. Installazzjoni fuq Windows
  4. Ivvjerifika l-Installazzjoni
  5. Soluzzjoni ta’ Problemi Komuni
  6. Punti Ewlenin

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 curl huwa l-aktar metodu veloċi
  • uv tool install huwa l-metodu rrakkomandat biex jiġu evitati kunflitti
  • Fuq Windows, ippreferi WSL għal esperjenza aħjar
  • Ivvjerifika l-installazzjoni b’vibe --version