Instalar a CLI Mistral Vibe
Nesta página
Pré-requisitos
Antes de instalar o Vibe, certifique-se de que o seu sistema tem o Python 3.12 ou superior. Esta é a única dependência técnica obrigatória e também a causa mais comum de falhas: muitas máquinas Linux ainda vêm com o Python 3.10 ou 3.11 por predefinição. Comece por verificar a sua versão:
python3 --version
# ou nalguns sistemas
python --version
Se vir uma versão inferior à 3.12, atualize o Python a partir do sítio oficial ou através do seu gestor de pacotes. Não prossiga até resolver isto: uma instalação lançada numa versão mais antiga falha com um erro de resolução de dependências que não indica a causa real.
Instalação no Mac e Linux
O método mais rápido no Mac e no Linux é o script de instalação oficial. Basta um único comando:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Este script deteta o seu sistema, instala o uv — o gestor de pacotes Python ultrarrápido — se necessário, e depois instala o Vibe como uma ferramenta global. Assim que terminar, o comando vibe estará disponível no seu terminal.
Alternativa com uv
Se já utiliza o uv, pode instalar o Vibe diretamente sem executar o script:
uv tool install mistral-vibe
O uv gere automaticamente o ambiente virtual e as dependências. Este é o método preferido se trabalhar em vários projetos Python e quiser evitar conflitos: o Vibe vive no seu próprio ambiente isolado e nunca substituirá a versão de uma biblioteca da qual um dos seus projetos dependa.
Alternativa com pip
Para uma instalação clássica via pip:
pip install mistral-vibe
Isto funciona, mas instala o Vibe no ambiente Python atual, acarretando o risco de colisões. Se encontrar conflitos de dependências, isole a ferramenta num ambiente virtual dedicado:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Tenha em mente que, com esta abordagem, o comando vibe só está disponível quando o ambiente está ativado.
Instalação no Windows
O Windows é suportado, embora o Vibe seja concebido principalmente para ambientes UNIX. A instalação ocorre via PowerShell em dois passos: o primeiro comando instala o uv e o segundo instala o Vibe.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
Após a instalação, abra um novo terminal para que o comando vibe seja reconhecido: a sessão PowerShell atual mantém o PATH antigo e dir-lhe-ia que o comando não existe, mesmo estando instalado.
Windows com WSL
Se utilizar o WSL (Subsistema Windows para Linux), siga simplesmente as instruções para Mac/Linux. Este é, aliás, o método recomendado para uma experiência ótima no Windows, porque os comandos de shell que o agente executa foram concebidos para um ambiente UNIX:
# No seu terminal WSL
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Verificar a Instalação
Independentemente do método utilizado, termine sempre com uma verificação. Esta é a única forma de saber se o binário está verdadeiramente acessível a partir da sua shell:
vibe --version
Deverá ver o número da versão apresentado (3.0.4 a partir de 2 de novembro de 2026; a geração 3.0 data de 19 de outubro de 2026). Se o comando não for encontrado, quase nunca é porque a instalação falhou: significa que o diretório de instalação não está no seu PATH.
Resolução de Problemas Comuns
O comando vibe não é encontrado
Após a instalação via uv, o binário encontra-se geralmente em ~/.local/bin/. Se este diretório não estiver declarado no seu PATH, a sua shell não o consegue detetar. Adicione-o ao seu ficheiro de configuração:
# Em ~/.bashrc ou ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
Depois, recarregue a sua shell para que a alteração tenha efeito na sessão atual:
source ~/.bashrc
# ou
source ~/.zshrc
Erro de cache com uv
Por vezes, uma instalação anterior deixa uma cache corrompida, tipicamente após uma interrupção de rede. A instalação falha então com um erro que menciona a cache. Volte a executar o comando contornando-a:
uv tool install mistral-vibe --no-cache
Conflito de versão do Python
Numa máquina onde coexistem vários interpretadores — um Python 3.11 do sistema e um 3.12 instalado manualmente, por exemplo —, o uv pode selecionar o errado. Force explicitamente a versão de destino:
uv tool install mistral-vibe --python python3.12
Estas três situações cobrem quase todas as instalações bloqueadas. Crie o hábito de voltar a executar vibe --version após cada correção.
Pontos-chave
- O Python 3.12+ é o único pré-requisito técnico
- No Mac/Linux, o script
curlé o método mais rápido uv tool installé o método recomendado para evitar conflitos- No Windows, prefira o WSL para uma melhor experiência
- Verifique a instalação com
vibe --version