Mistral Vibe CLI installeren
Op deze pagina
Vereisten
Voordat u Vibe installeert, moet u controleren of uw systeem beschikt over Python 3.12 of hoger. Dit is de enige verplichte technische afhankelijkheid en tevens de meest voorkomende oorzaak van mislukkingen: veel Linux-machines worden standaard geleverd met Python 3.10 of 3.11. Begin met het controleren van uw versie:
python3 --version
# of op sommige systemen
python --version
Als u een versie lager dan 3.12 ziet, update Python dan via de officiële website of uw pakketbeheerder. Ga niet verder voordat u dit heeft opgelost: een installatie die op een oudere versie wordt gestart, faalt met een foutmelding over het oplossen van afhankelijkheden die de werkelijke oorzaak niet aangeeft.
Installatie op Mac en Linux
De snelste methode op Mac en Linux is het officiële installatiescript. U heeft slechts één commando nodig:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Dit script detecteert uw systeem, installeert uv—de ultrasnelle Python-pakketbeheerder—indien nodig, en installeert vervolgens Vibe als een globaal hulpmiddel. Zodra dit is voltooid, is het commando vibe beschikbaar in uw terminal.
Alternatief met uv
Als u uv al gebruikt, kunt u Vibe direct installeren zonder het script uit te voeren:
uv tool install mistral-vibe
uv regelt automatisch de virtuele omgeving en de afhankelijkheden. Dit is de voorkeursmethode als u aan meerdere Python-projecten werkt en conflicten wilt vermijden: Vibe leeft in zijn eigen geïsoleerde omgeving en zal nooit een bibliotheekversie overschrijven waarvan een van uw projecten afhankelijk is.
Alternatief met pip
Voor een klassieke installatie via pip:
pip install mistral-vibe
Dit werkt, maar het installeert Vibe in de huidige Python-omgeving, wat het risico op conflicten met zich meebrengt. Als u afhankelijkheidsconflicten tegenkomt, isoleer het hulpmiddel dan in een toegewijde virtuele omgeving:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Houd er rekening mee dat bij deze aanpak het commando vibe alleen beschikbaar is wanneer de omgeving is geactiveerd.
Installatie op Windows
Windows wordt ondersteund, hoewel Vibe primair is ontworpen voor UNIX-omgevingen. De installatie verloopt via PowerShell in twee stappen: het eerste commando installeert uv, en het tweede installeert Vibe.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
Open na de installatie een nieuwe terminal zodat het commando vibe wordt herkend: de huidige PowerShell-sessie behoudt het oude PATH en zal melden dat het commando niet bestaat, ook al is het geïnstalleerd.
Windows met WSL
Als u WSL (Windows Subsystem for Linux) gebruikt, volgt u eenvoudig de instructies voor Mac/Linux. Dit is eigenlijk de aanbevolen methode voor een optimale ervaring op Windows, omdat de shell-commando’s die de agent uitvoert, zijn ontworpen voor een UNIX-omgeving:
# In uw WSL-terminal
curl -LsSf https://mistral.ai/vibe/install.sh | bash
De installatie verifiëren
Ongeacht de gebruikte methode, sluit u altijd af met een verificatie. Dit is de enige manier om te weten of het binary-bestand echt toegankelijk is vanuit uw shell:
vibe --version
U zou het versienummer moeten zien weergegeven (3.0.4 per 2 november 2026; generatie 3.0 dateert van 19 oktober 2026). Als het commando niet wordt gevonden, ligt dat bijna nooit aan een mislukte installatie: het betekent dat de installatiemap niet in uw PATH staat.
Oplossen van veelvoorkomende problemen
Het commando vibe wordt niet gevonden
Na installatie via uv bevindt het binary-bestand zich meestal in ~/.local/bin/. Als deze map niet is gedeclareerd in uw PATH, kan uw shell deze niet zien. Voeg deze toe aan uw configuratiebestand:
# In ~/.bashrc of ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
Herlaad vervolgens uw shell zodat de wijziging van kracht wordt in de huidige sessie:
source ~/.bashrc
# of
source ~/.zshrc
Cache-fout met uv
Soms laat een eerdere installatie een beschadigde cache achter, typisch na een netwerkonderbreking. De installatie faalt dan met een foutmelding die de cache noemt. Voer het commando opnieuw uit terwijl u de cache omzeilt:
uv tool install mistral-vibe --no-cache
Conflict met Python-versie
Op een machine waar meerdere interpreters naast elkaar bestaan—bijvoorbeeld een systeem-Python 3.11 en een handmatig geïnstalleerde 3.12—kan uv de verkeerde selecteren. Forceer expliciet de doelversie:
uv tool install mistral-vibe --python python3.12
Deze drie situaties dekken bijna alle vastgelopen installaties. Maak er een gewoonte van om vibe --version opnieuw uit te voeren na elke oplossing.
Belangrijkste punten
- Python 3.12+ is de enige technische vereiste
- Op Mac/Linux is het
curl-script de snelste methode uv tool installis de aanbevolen methode om conflicten te vermijden- Op Windows geeft u de voorkeur aan WSL voor een betere ervaring
- Verifieer de installatie met
vibe --version