Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Installazione di Mistral Vibe CLI

Lezione 2 di 16 Aggiornata il 2 novembre 2026 Sviluppatore
In questa pagina
  1. Prerequisiti
  2. Installazione su Mac e Linux
  3. Installazione su Windows
  4. Verifica dell’installazione
  5. Risoluzione dei problemi comuni
  6. Punti chiave

Prerequisiti

Prima di installare Vibe, assicurati che il tuo sistema disponga di Python 3.12 o superiore. Questa è l’unica dipendenza tecnica obbligatoria ed è anche la causa di errore più frequente: molte macchine Linux vengono fornite di default con Python 3.10 o 3.11. Inizia verificando la tua versione:

python3 --version
# o su alcuni sistemi
python --version

Se vedi una versione inferiore alla 3.12, aggiorna Python dal sito ufficiale o tramite il tuo gestore di pacchetti. Non procedere finché non hai risolto il problema: un’avvio dell’installazione su una versione obsoleta fallisce con un errore di risoluzione delle dipendenze che non indica la causa reale.

Installazione su Mac e Linux

Il metodo più rapido su Mac e Linux è lo script di installazione ufficiale. Ti basta un singolo comando:

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

Questo script rileva il tuo sistema, installa uv (il gestore di pacchetti Python ultra-veloce) se necessario, e poi installa Vibe come strumento globale. Al termine, il comando vibe sarà disponibile nel tuo terminale.

Alternativa con uv

Se utilizzi già uv, puoi installare Vibe direttamente senza eseguire lo script:

uv tool install mistral-vibe

uv gestisce automaticamente l’ambiente virtuale e le dipendenze. Questo è il metodo preferito se lavori su più progetti Python e vuoi evitare conflitti: Vibe risiede nel proprio ambiente isolato e non sovrascriverà mai la versione di una libreria da cui dipende uno dei tuoi progetti.

Alternativa con pip

Per un’installazione classica tramite pip:

pip install mistral-vibe

Funziona, ma installa Vibe nell’ambiente Python corrente, comportando il rischio di collisioni. Se incontri conflitti di dipendenze, isola lo strumento in un ambiente virtuale dedicato:

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

Tieni presente che con questo approccio, il comando vibe è disponibile solo quando l’ambiente è attivato.

Installazione su Windows

Windows è supportato, sebbene Vibe sia progettato principalmente per ambienti UNIX. L’installazione avviene tramite PowerShell in due passaggi: il primo comando installa uv e il secondo installa Vibe.

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

Dopo l’installazione, apri un nuovo terminale affinché il comando vibe venga riconosciuto: la sessione PowerShell corrente mantiene il vecchio PATH e ti direbbe che il comando non esiste, anche se è installato.

Windows con WSL

Se utilizzi WSL (Windows Subsystem for Linux), segui semplicemente le istruzioni per Mac/Linux. Questo è anzi il metodo raccomandato per un’esperienza ottimale su Windows, poiché i comandi shell eseguiti dall’agente sono progettati per un ambiente UNIX:

# Nel tuo terminale WSL
curl -LsSf https://mistral.ai/vibe/install.sh | bash

Verifica dell’installazione

Indipendentemente dal metodo utilizzato, termina sempre con una verifica. È l’unico modo per sapere se il binario è realmente accessibile dalla tua shell:

vibe --version

Dovresti vedere visualizzato il numero di versione (3.0.4 al 2 novembre 2026; la generazione 3.0 è datata 19 ottobre 2026). Se il comando non viene trovato, quasi mai è perché l’installazione è fallita: significa che la directory di installazione non è nel tuo PATH.

Risoluzione dei problemi comuni

Il comando vibe non viene trovato

Dopo l’installazione tramite uv, il binario si trova solitamente in ~/.local/bin/. Se questa directory non è dichiarata nel tuo PATH, la tua shell non può vederla. Aggiungila al tuo file di configurazione:

# In ~/.bashrc o ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"

Quindi ricarica la tua shell affinché la modifica abbia effetto nella sessione corrente:

source ~/.bashrc
# oppure
source ~/.zshrc

Errore di cache con uv

A volte una installazione precedente lascia una cache corrotta, tipicamente dopo un’interruzione di rete. L’installazione fallisce quindi con un errore che menziona la cache. Riesegui il comando bypassandola:

uv tool install mistral-vibe --no-cache

Conflitto di versione Python

Su una macchina dove coesistono più interpreti (un Python di sistema 3.11 e uno installato manualmente 3.12, ad esempio), uv potrebbe selezionare quello sbagliato. Forza esplicitamente la versione target:

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

Queste tre situazioni coprono quasi tutte le installazioni bloccate. Prendi l’abitudine di rieseguire vibe --version dopo ogni correzione.

Punti chiave

  • Python 3.12+ è l’unico prerequisito tecnico
  • Su Mac/Linux, lo script curl è il metodo più veloce
  • uv tool install è il metodo raccomandato per evitare conflitti
  • Su Windows, preferisci WSL per un’esperienza migliore
  • Verifica l’installazione con vibe --version