Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Instalace Mistral Vibe CLI

Lekce 2 z 16 Aktualizováno 2. listopadu 2026 Vývojář
Na této stránce
  1. Předpoklady
  2. Instalace na Mac a Linux
  3. Instalace na Windows
  4. Ověření instalace
  5. Řešení běžných problémů
  6. Klíčové poznatky

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 curl nejrychlejší metodou
  • uv tool install je doporučená metoda pro vyhnutí se konfliktům
  • Na Windows upřednostni WSL pro lepší zážitek
  • Ověř instalaci příkazem vibe --version