Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Instalar a CLI Mistral Vibe

Aula 2 de 16 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Pré-requisitos
  2. Instalação no Mac e Linux
  3. Instalação no Windows
  4. Verificar a Instalação
  5. Resolução de Problemas Comuns
  6. Pontos-chave

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