Installazione di Mistral Vibe CLI
In questa pagina
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