Instalación de Mistral Vibe CLI
En esta página
Requisitos previos
Antes de instalar Vibe, asegúrate de que tu sistema tiene Python 3.12 o superior. Esta es la única dependencia técnica obligatoria y, a la vez, la causa más frecuente de fallos: muchas máquinas Linux siguen incluyendo Python 3.10 o 3.11 por defecto. Empieza comprobando tu versión:
python3 --version
# o en algunos sistemas
python --version
Si ves una versión inferior a 3.12, actualiza Python desde el sitio web oficial o mediante tu gestor de paquetes. No continúes hasta resolver esto: una instalación lanzada sobre una versión antigua fallará con un error de resolución de dependencias que no indica la causa real.
Instalación en Mac y Linux
El método más rápido en Mac y Linux es el script de instalación oficial. Solo necesitas un comando:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Este script detecta tu sistema, instala uv (el gestor de paquetes de Python ultrarrápido) si es necesario y, a continuación, instala Vibe como una herramienta global. Una vez finalizado, el comando vibe estará disponible en tu terminal.
Alternativa con uv
Si ya utilizas uv, puedes instalar Vibe directamente sin ejecutar el script:
uv tool install mistral-vibe
uv gestiona automáticamente el entorno virtual y las dependencias. Este es el método preferido si trabajas en varios proyectos de Python y quieres evitar conflictos: Vibe reside en su propio entorno aislado y nunca sobrescribirá la versión de una biblioteca de la que dependa alguno de tus proyectos.
Alternativa con pip
Para una instalación clásica mediante pip:
pip install mistral-vibe
Esto funciona, pero instala Vibe en el entorno de Python actual, lo que conlleva el riesgo de colisiones. Si encuentras conflictos de dependencias, aísla la herramienta en un entorno virtual dedicado:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Ten en cuenta que, con este enfoque, el comando vibe solo está disponible cuando el entorno está activado.
Instalación en Windows
Windows es compatible, aunque Vibe está diseñado principalmente para entornos UNIX. La instalación se realiza mediante PowerShell en dos pasos: el primer comando instala uv y el segundo instala Vibe.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
Tras la instalación, abre un nuevo terminal para que el comando vibe sea reconocido: la sesión actual de PowerShell conserva la variable PATH antigua y te indicará que el comando no existe, aunque esté instalado.
Windows con WSL
Si utilizas WSL (Subsistema de Windows para Linux), sigue simplemente las instrucciones para Mac/Linux. De hecho, este es el método recomendado para obtener una experiencia óptima en Windows, porque los comandos de shell que ejecuta el agente están diseñados para un entorno UNIX:
# En tu terminal de WSL
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Verificación de la instalación
Independientemente del método utilizado, finaliza siempre con una verificación. Es la única forma de saber si el binario es realmente accesible desde tu shell:
vibe --version
Deberías ver el número de versión mostrado (3.0.4 a fecha de 2 de noviembre de 2026; la generación 3.0 es del 19 de octubre de 2026). Si el comando no se encuentra, casi nunca es porque la instalación haya fallado: significa que el directorio de instalación no está en tu PATH.
Solución de problemas comunes
El comando vibe no se encuentra
Tras la instalación mediante uv, el binario suele ubicarse en ~/.local/bin/. Si este directorio no está declarado en tu PATH, tu shell no puede verlo. Añádelo a tu archivo de configuración:
# En ~/.bashrc o ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
A continuación, recarga tu shell para que el cambio surta efecto en la sesión actual:
source ~/.bashrc
# o
source ~/.zshrc
Error de caché con uv
A veces, una instalación anterior deja una caché corrupta, normalmente tras una interrupción de red. La instalación falla entonces con un error que menciona la caché. Vuelve a ejecutar el comando omitiéndola:
uv tool install mistral-vibe --no-cache
Conflicto de versión de Python
En una máquina donde coexisten varios intérpretes (un Python 3.11 del sistema y un 3.12 instalado manualmente, por ejemplo), uv podría seleccionar el incorrecto. Fuerza explícitamente la versión de destino:
uv tool install mistral-vibe --python python3.12
Estas tres situaciones cubren casi todas las instalaciones bloqueadas. Acostúmbrate a volver a ejecutar vibe --version tras cada corrección.
Puntos clave
- Python 3.12+ es el único requisito técnico previo
- En Mac/Linux, el script
curles el método más rápido uv tool installes el método recomendado para evitar conflictos- En Windows, prefiere WSL para una mejor experiencia
- Verifica la instalación con
vibe --version