Instalarea Mistral Vibe CLI
Pe această pagină
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
curleste cea mai rapidă metodă uv tool installeste metoda recomandată pentru a evita conflictele- Pe Windows, preferați WSL pentru o experiență mai bună
- Verificați instalarea cu
vibe --version