Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

A Mistral Vibe CLI telepítése

2. lecke 16 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Előfeltételek
  2. Telepítés Mac és Linux rendszeren
  3. Telepítés Windows rendszeren
  4. A telepítés ellenőrzése
  5. Gyakori problémák megoldása
  6. Főbb megállapítások

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 curl szkript a leggyorsabb módszer
  • Az uv tool install az 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 --version paranccsal