Instalace Mistral Vibe CLI
Na této stránce
Předpoklady
Než začneš instalovat Vibe, ujisti se, že máš v systému nainstalovaný Python 3.12 nebo vyšší. Toto je jediná povinná technická závislost a zároveň nejčastější zdroj problémů: mnoho linuxových strojů stále ve výchozím nastavení dodává Python 3.10 nebo 3.11. Začni kontrolou své verze:
python3 --version
# nebo na některých systémech
python --version
Pokud uvidíš verzi nižší než 3.12, aktualizuj Python z oficiálních webových stránek nebo prostřednictvím svého správce balíčků. Nepokračuj, dokud toto nevyřešíš: instalace spuštěná na starší verzi selže s chybou řešení závislostí, která neindikuje skutečnou příčinu.
Instalace na Mac a Linux
Nejrychlejší metodou na Macu a Linuxu je oficiální instalační skript. Stačí jediný příkaz:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Tento skript detekuje tvůj systém, v případě potřeby nainstaluje uv – ultra-rychlý správce balíčků pro Python – a následně nainstaluje Vibe jako globální nástroj. Po dokončení je příkaz vibe dostupný v tvém terminálu.
Alternativa s uv
Pokud již používáš uv, můžeš Vibe nainstalovat přímo bez spouštění skriptu:
uv tool install mistral-vibe
uv automaticky zpracuje virtuální prostředí a závislosti. Toto je preferovaná metoda, pokud pracuješ na více projektech v Pythonu a chceš se vyhnout konfliktům: Vibe běží ve vlastním izolovaném prostředí a nikdy nepřepíše verzi knihovny, na které závisí jeden z tvých projektů.
Alternativa s pip
Pro klasickou instalaci přes pip:
pip install mistral-vibe
Toto funguje, ale instaluje Vibe do aktuálního prostředí Pythonu, což nese riziko kolizí. Pokud narazíš na konflikty závislostí, izoluj nástroj do vyhrazeného virtuálního prostředí:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Měj na paměti, že při tomto přístupu je příkaz vibe dostupný pouze tehdy, když je prostředí aktivováno.
Instalace na Windows
Windows jsou podporovány, ačkoli je Vibe primárně navržen pro prostředí UNIX. Instalace probíhá přes PowerShell ve dvou krocích: první příkaz instaluje uv a druhý instaluje Vibe.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
Po instalaci otevři nový terminál, aby byl příkaz vibe rozpoznán: aktuální relace PowerShellu si ponechá starou proměnnou PATH a hlásila by ti, že příkaz neexistuje, přestože je nainstalován.
Windows s WSL
Pokud používáš WSL (Windows Subsystem for Linux), jednoduše postupuj podle pokynů pro Mac/Linux. Toto je ve skutečnosti doporučená metoda pro optimální zážitek na Windows, protože příkazy shellu, které agent执行, jsou navrženy pro prostředí UNIX:
# Ve tvém terminálu WSL
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Ověření instalace
Bez ohledu na použitou metodu vždy dokonči proces ověřením. Je to jediný způsob, jak zjistit, zda je binární soubor skutečně dostupný z tvého shellu:
vibe --version
Měl bys vidět zobrazené číslo verze (k 2. listopadu 2026 je to 3.0.4; generace 3.0 pochází z 19. října 2026). Pokud příkaz není nalezen, téměř nikdy to neznamená, že instalace selhala: znamená to, že instalační adresář není v tvé proměnné PATH.
Řešení běžných problémů
Příkaz vibe nebyl nalezen
Po instalaci přes uv se binární soubor obvykle nachází v ~/.local/bin/. Pokud tento adresář není uveden v tvé proměnné PATH, tvůj shell ho nevidí. Přidej jej do svého konfiguračního souboru:
# V ~/.bashrc nebo ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
Poté znovu načti shell, aby se změna projevila v aktuální relaci:
source ~/.bashrc
# nebo
source ~/.zshrc
Chyba mezipaměti s uv
Někdy předchozí instalace zanechá poškozenou mezipaměť, typicky po přerušení sítě. Instalace pak selže s chybou zmiňující mezipaměť. Spusť příkaz znovu s jejím obejitím:
uv tool install mistral-vibe --no-cache
Konflikt verze Pythonu
Na stroji, kde koexistuje více interpretů – například systémový Python 3.11 a ručně nainstalovaný 3.12 – může uv vybrat ten špatný. Explicitně vynuť cílovou verzi:
uv tool install mistral-vibe --python python3.12
Tyto tři situace pokrývají téměř všechny zaseknuté instalace. Zvykni si po každé opravě znovu spustit vibe --version.
Klíčové poznatky
- Python 3.12+ je jedinou technickou podmínkou
- Na Mac/Linux je skript
curlnejrychlejší metodou uv tool installje doporučená metoda pro vyhnutí se konfliktům- Na Windows upřednostni WSL pro lepší zážitek
- Ověř instalaci příkazem
vibe --version