Installer Mistral Vibe CLI

Prérequis avant l’installation

Avant d’installer Vibe, assurez-vous que votre système dispose de Python 3.12 ou supérieur. C’est la seule dépendance technique obligatoire, et c’est aussi la source d’échec la plus fréquente : beaucoup de machines Linux livrent encore un Python 3.10 ou 3.11 par défaut. Commencez donc par le vérifier :

python3 --version
# ou sur certains systèmes
python --version

Si vous obtenez une version inférieure à 3.12, mettez à jour Python depuis le site officiel ou via votre gestionnaire de paquets. Ne passez pas à la suite avant d’avoir corrigé ce point : une installation lancée sur une version trop ancienne échoue sur un message de résolution de dépendances qui n’indique pas la cause réelle.

Installation sur Mac et Linux

La méthode la plus rapide sur Mac et Linux est le script d’installation officiel. Une seule commande suffit :

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

Ce script détecte votre système, installe uv — le gestionnaire de paquets Python ultra-rapide — si nécessaire, puis installe Vibe comme outil global. À la fin, la commande vibe est disponible dans votre terminal.

Alternative avec uv

Si vous utilisez déjà uv, vous pouvez installer Vibe directement, sans passer par le script :

uv tool install mistral-vibe

uv gère automatiquement l’environnement virtuel et les dépendances. C’est la méthode privilégiée si vous travaillez sur plusieurs projets Python et souhaitez éviter les conflits : Vibe vit dans son propre environnement isolé et ne viendra jamais écraser la version d’une bibliothèque dont dépend l’un de vos projets.

Alternative avec pip

Pour une installation classique via pip :

pip install mistral-vibe

Cette voie fonctionne, mais elle installe Vibe dans l’environnement Python courant, avec le risque de collision que cela suppose. Si vous rencontrez des conflits de dépendances, isolez l’outil dans un environnement virtuel dédié :

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

Gardez en tête qu’avec cette approche, la commande vibe ne sera disponible que lorsque l’environnement est activé.

Installation sur Windows

Windows est supporté, bien que Vibe soit principalement conçu pour les environnements UNIX. L’installation passe par PowerShell et se fait en deux temps : la première commande installe uv, la seconde installe Vibe.

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

Après l’installation, ouvrez un nouveau terminal pour que la commande vibe soit reconnue : la session PowerShell en cours conserve l’ancien PATH et vous répondrait que la commande n’existe pas, alors qu’elle est bien installée.

Windows avec WSL

Si vous utilisez WSL (Windows Subsystem for Linux), suivez simplement les instructions Mac/Linux. C’est d’ailleurs la méthode recommandée pour une expérience optimale sous Windows, car les commandes shell que l’agent exécute sont pensées pour un environnement UNIX :

# Dans votre terminal WSL
curl -LsSf https://mistral.ai/vibe/install.sh | bash

Vérifier l’installation

Quelle que soit la méthode utilisée, terminez toujours par une vérification. C’est le seul moyen de savoir si le binaire est réellement accessible depuis votre shell :

vibe --version

Vous devriez voir le numéro de version s’afficher (2.1.0 ou supérieur en avril 2026). Si la commande n’est pas trouvée, ce n’est presque jamais que l’installation a échoué : c’est que le répertoire d’installation n’est pas dans votre PATH.

Résolution des problèmes courants

La commande `vibe` n’est pas trouvée

Après l’installation via uv, le binaire se trouve généralement dans ~/.local/bin/. Si ce répertoire n’est pas déclaré dans votre PATH, votre shell ne peut pas le voir. Ajoutez-le à votre fichier de configuration :

# Dans ~/.bashrc ou ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"

Rechargez ensuite votre shell pour que la modification prenne effet dans la session en cours :

source ~/.bashrc
# ou
source ~/.zshrc

Erreur de cache avec uv

Il arrive qu’une installation précédente laisse un cache corrompu, typiquement après une interruption réseau. L’installation échoue alors sur une erreur qui mentionne le cache. Reprenez la commande en le contournant :

uv tool install mistral-vibe --no-cache

Conflit de version Python

Sur un poste où cohabitent plusieurs interpréteurs — un Python 3.11 système et un 3.12 installé à la main, par exemple — uv peut sélectionner le mauvais. Forcez explicitement la version cible :

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

Ces trois situations couvrent la quasi-totalité des installations qui coincent. Prenez le réflexe de relancer vibe --version après chaque correction.

Points clés à retenir

Python 3.12+ est le seul prérequis technique
Sur Mac/Linux, le script curl est la méthode la plus rapide
uv tool install est la méthode recommandée pour éviter les conflits
Sur Windows, privilégiez WSL pour une meilleure expérience
Vérifiez l’installation avec vibe --version