Salt la conținutul principal
Română— Alege o limbă
Meniu

Instalarea Mistral Vibe CLI

Lecția 2 din 16 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Condiții prealabile
  2. Instalare pe Mac și Linux
  3. Instalare pe Windows
  4. Verificarea instalării
  5. Depanarea problemelor frecvente
  6. Puncte cheie

Condiții prealabile

Înainte de a instala Vibe, asigurați-vă că sistemul dumneavoastră are Python 3.12 sau o versiune superioară. Aceasta este singura dependență tehnică obligatorie și, totodată, cea mai frecventă sursă de eșec: multe mașini Linux vin implicit cu Python 3.10 sau 3.11. Începeți prin verificarea versiunii:

python3 --version
# sau pe unele sisteme
python --version

Dacă vedeți o versiune mai mică de 3.12, actualizați Python de pe site-ul oficial sau prin managerul de pachete. Nu continuați până nu remediați această problemă: o instalare lansată pe o versiune veche eșuează cu o eroare de rezolvare a dependențelor care nu indică adevărata cauză.

Instalare pe Mac și Linux

Cea mai rapidă metodă pe Mac și Linux este scriptul oficial de instalare. Aveți nevoie de o singură comandă:

curl -LsSf https://mistral.ai/vibe/install.sh | bash

Acest script detectează sistemul, instalează uv—managerul de pachete Python ultra-rapid—dacă este necesar, și apoi instalează Vibe ca instrument global. Odată finalizat, comanda vibe este disponibilă în terminal.

Alternativă cu uv

Dacă utilizați deja uv, puteți instala Vibe direct, fără a rula scriptul:

uv tool install mistral-vibe

uv gestionează automat mediul virtual și dependențele. Aceasta este metoda preferată dacă lucrați la multiple proiecte Python și doriți să evitați conflictele: Vibe rulează în propriul său mediu izolat și nu va suprascrie niciodată o versiune de bibliotecă de care depinde unul dintre proiectele dumneavoastră.

Alternativă cu pip

Pentru o instalare clasică prin pip:

pip install mistral-vibe

Aceasta funcționează, dar instalează Vibe în mediul Python curent, ceea ce prezintă riscul unor coliziuni. Dacă întâmpinați conflicte de dependențe, izolați instrumentul într-un mediu virtual dedicat:

python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe

Rețineți că, cu această abordare, comanda vibe este disponibilă doar atunci când mediul este activat.

Instalare pe Windows

Windows este suportat, deși Vibe este conceput în primul rând pentru medii UNIX. Instalarea se face prin PowerShell în doi pași: prima comandă instalează uv, iar a doua instalează Vibe.

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe

După instalare, deschideți un terminal nou pentru ca comanda vibe să fie recunoscută: sesiunea PowerShell curentă păstrează vechea variabilă PATH și vă va indica faptul că comanda nu există, chiar dacă aceasta este instalată.

Windows cu WSL

Dacă utilizați WSL (Windows Subsystem for Linux), urmați pur și simplu instrucțiunile pentru Mac/Linux. Aceasta este, de fapt, metoda recomandată pentru o experiență optimă pe Windows, deoarece comenzile shell executate de agent sunt concepute pentru un mediu UNIX:

# În terminalul WSL
curl -LsSf https://mistral.ai/vibe/install.sh | bash

Verificarea instalării

Indiferent de metoda utilizată, finalizați întotdeauna cu o verificare. Acesta este singurul mod de a ști dacă binarul este cu adevărat accesibil din shell-ul dumneavoastră:

vibe --version

Ar trebui să vedeți afișat numărul versiunii (3.0.4 la data de 2 noiembrie 2026; generația 3.0 datează din 19 octombrie 2026). Dacă comanda nu este găsită, aproape niciodată nu este din cauza unui eșec al instalării: înseamnă că directorul de instalare nu se află în variabila PATH.

Depanarea problemelor frecvente

Comanda vibe nu este găsită

După instalarea prin uv, binarul se află de obicei în ~/.local/bin/. Dacă acest director nu este declarat în PATH, shell-ul nu îl poate vedea. Adăugați-l în fișierul de configurație:

# În ~/.bashrc sau ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"

Apoi reîncărcați shell-ul pentru ca modificarea să aibă efect în sesiunea curentă:

source ~/.bashrc
# sau
source ~/.zshrc

Eroare de cache cu uv

Uneori, o instalare anterioară lasă un cache corupt, de obicei după o întrerupere de rețea. Instalarea eșuează apoi cu o eroare care menționează cache-ul. Rerulați comanda ocolind cache-ul:

uv tool install mistral-vibe --no-cache

Conflict de versiune Python

Pe o mașină unde coexistă multiple interpretoare—un Python 3.11 de sistem și unul 3.12 instalat manual, de exemplu—uv ar putea selecta versiunea greșită. Forțați explicit versiunea țintă:

uv tool install mistral-vibe --python python3.12

Aceste trei situații acoperă aproape toate instalările blocate. Obișnuiți-vă să rerulați vibe --version după fiecare remediere.

Puncte cheie

  • Python 3.12+ este singura condiție prealabilă tehnică
  • Pe Mac/Linux, scriptul curl este cea mai rapidă metodă
  • uv tool install este metoda recomandată pentru a evita conflictele
  • Pe Windows, preferați WSL pentru o experiență mai bună
  • Verificați instalarea cu vibe --version