A Mistral Vibe CLI telepítése
Ezen az oldalon
Előfeltételek
Mielőtt telepítenéd a Vibe-ot, győződj meg róla, hogy a rendszereden Python 3.12 vagy újabb verzió fut. Ez az egyetlen kötelező technikai függőség, egyben a leggyakoribb hibaforrás is: sok Linux-gép alapértelmezetten még mindig Python 3.10-es vagy 3.11-es verzióval érkezik. Kezdésnek ellenőrizd a verziódat:
python3 --version
# vagy egyes rendszereken
python --version
Ha 3.12-nél régebbi verziót látsz, frissítsd a Pythont a hivatalos weboldalról vagy a csomagkezelődön keresztül. Ne folytasd, amíg ezt nem javítod: egy régebbi verzióra indított telepítés függőségfeloldási hibával megszakad, ami nem utal a valódi okra.
Telepítés Mac és Linux rendszeren
Mac és Linux alatt a leggyorsabb módszer a hivatalos telepítőszkript használata. Egyetlen parancsra van szükséged:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Ez a szkript felismeri a rendszeredet, szükség esetén telepíti az uv-t – a villámgyors Python-csomagkezelőt –, majd globális eszközként telepíti a Vibe-ot. A folyamat végén a vibe parancs elérhetővé válik a terminálodban.
Alternatív megoldás uv-val
Ha már használod az uv-t, közvetlenül is telepítheted a Vibe-ot a szkript futtatása nélkül:
uv tool install mistral-vibe
Az uv automatikusan kezeli a virtuális környezetet és a függőségeket. Ez az ajánlott módszer, ha több Python-projekten dolgozol, és el akarod kerülni az ütközéseket: a Vibe saját izolált környezetben fut, így soha nem ír felül olyan könyvtárverziót, amelyre valamelyik projekted támaszkodik.
Alternatív megoldás pip-pel
Klasszikus telepítés pip segítségével:
pip install mistral-vibe
Ez működik, de az aktuális Python-környezetbe telepíti a Vibe-ot, ami ütközések kockázatát hordozza. Ha függőségkonfliktusokba ütközöl, izoláld az eszközt egy dedikált virtuális környezetbe:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Ne feledd, hogy ennél a megközelítésnél a vibe parancs csak akkor érhető el, ha a környezet aktiválva van.
Telepítés Windows rendszeren
A Windows támogatott, bár a Vibe-ot elsősorban UNIX-környezetekre tervezték. A telepítés PowerShell segítségével történik, két lépésben: az első parancs az uv-t telepíti, a második pedig a Vibe-ot.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
A telepítés után nyiss egy új terminált, hogy a vibe parancs felismerhető legyen: az aktuális PowerShell-munkamenet megtartja a régi PATH értéket, és azt jelezné, hogy a parancs nem létezik, holott telepítve van.
Windows WSL-lel
Ha WSL-t (Windows Subsystem for Linux) használsz, egyszerűen kövesd a Mac/Linuxra vonatkozó utasításokat. Ez valójában az ajánlott módszer a legjobb windowsos élményhez, mivel az ügynök által végrehajtott shell-parancsok UNIX-környezetre lettek tervezve:
# A WSL terminálodban
curl -LsSf https://mistral.ai/vibe/install.sh | bash
A telepítés ellenőrzése
Bármelyik módszert is választottad, mindig fejezd be ellenőrzéssel. Csak így győződhetsz meg arról, hogy a bináris fájl valóban elérhető-e a shellből:
vibe --version
A verziószám megjelenik (2026. november 2-án ez a 3.0.4; a 3.0-s generáció 2026. október 19-én jelent meg). Ha a parancs nem található, az szinte soha nem a telepítés sikertelenségét jelenti: azt jelenti, hogy a telepítési könyvtár nincs benne a PATH változódban.
Gyakori problémák megoldása
A vibe parancs nem található
uv-val történő telepítés után a bináris fájl általában a ~/.local/bin/ könyvtárban található. Ha ez a könyvtár nincs deklarálva a PATH változódban, a shell nem látja. Add hozzá a konfigurációs fájlodhoz:
# A ~/.bashrc vagy ~/.zshrc fájlban
export PATH="$HOME/.local/bin:$PATH"
Ezután töltsd újra a shellt, hogy a változás az aktuális munkamenetben is érvénybe lépjen:
source ~/.bashrc
# vagy
source ~/.zshrc
Gyorsítótár-hiba az uv-val
Előfordulhat, hogy egy korábbi telepítés sérült gyorsítótárat hagyott hátra, jellemzően hálózati megszakítás után. Ilyenkor a telepítés gyorsítótárra utaló hibával megszakad. Futtasd újra a parancsot a gyorsítótár megkerülésével:
uv tool install mistral-vibe --no-cache
Python-verzió konfliktus
Olyan gépeken, ahol több értelmező is共存 (például egy rendszer szintű Python 3.11 és egy kézzel telepített 3.12), az uv rosszat választhat. Kényszerítsd ki expliciten a célverziót:
uv tool install mistral-vibe --python python3.12
Ez a három helyzet lefedi a beragadt telepítések szinte összes esetét. Szoktasd rá magad, hogy minden javítás után újra lefuttatod a vibe --version parancsot.
Főbb megállapítások
- A Python 3.12+ az egyetlen technikai előfeltétel
- Mac/Linux alatt a
curlszkript a leggyorsabb módszer - Az
uv tool installaz ajánlott módszer az ütközések elkerülésére - Windows alatt a jobb élmény érdekében előnyben részesítsd a WSL-t
- Ellenőrizd a telepítést a
vibe --versionparanccsal