Инсталиране на Mistral Vibe CLI
На тази страница
Предварителни изисквания
Преди да инсталирате Vibe, уверете се, че системата Ви разполага с Python 3.12 или по-нова версия. Това е единствената задължителна техническа зависимост и същевременно най-честата причина за неуспех: много Linux машини все още идват с Python 3.10 или 3.11 по подразбиране. Започнете с проверка на версията:
python3 --version
# or on some systems
python --version
Ако видите версия, по-ниска от 3.12, актуализирайте Python от официалния уебсайт или чрез мениджъра на пакети. Не продължавайте, докато не отстраните този проблем: инсталация, стартирана на по-стара версия, се проваля с грешка в разрешаването на зависимостите, която не посочва истинската причина.
Инсталиране на Mac и Linux
Най-бързият метод за Mac и Linux е официалният скрипт за инсталиране. Нуждаете се само от една команда:
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Този скрипт открива Вашата система, инсталира uv – ултра-бързия мениджър на Python пакети – ако е необходимо, и след това инсталира Vibe като глобален инструмент. След приключване, командата vibe е достъпна във Вашия терминал.
Алтернатива с uv
Ако вече използвате uv, можете да инсталирате Vibe директно, без да стартирате скрипта:
uv tool install mistral-vibe
uv автоматично управлява виртуалната среда и зависимостите. Това е предпочитаният метод, ако работите по множество Python проекти и искате да избегнете конфликти: Vibe живее в собствена изолирана среда и никога няма да презапише версия на библиотека, от която зависи някой от Вашите проекти.
Алтернатива с pip
За класическа инсталация чрез pip:
pip install mistral-vibe
Това работи, но инсталира Vibe в текущата Python среда, което носи риск от конфликти. Ако срещнете проблеми със зависимостите, изолирайте инструмента в отделна виртуална среда:
python3 -m venv ~/.vibe-env
source ~/.vibe-env/bin/activate
pip install mistral-vibe
Имайте предвид, че при този подход командата vibe е достъпна само когато средата е активирана.
Инсталиране на Windows
Windows се поддържа, въпреки че Vibe е проектиран предимно за UNIX среди. Инсталацията се извършва чрез PowerShell на две стъпки: първата команда инсталира uv, а втората инсталира Vibe.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install mistral-vibe
След инсталацията отворете нов терминал, за да бъде разпозната командата vibe: текущата сесия на PowerShell запазва стария PATH и ще Ви съобщи, че командата не съществува, въпреки че е инсталирана.
Windows с WSL
Ако използвате WSL (Windows Subsystem for Linux), просто следвайте инструкциите за Mac/Linux. Всъщност това е препоръчителният метод за оптимално изживяване на Windows, защото shell командите, които агентът изпълнява, са проектирани за UNIX среда:
# In your WSL terminal
curl -LsSf https://mistral.ai/vibe/install.sh | bash
Проверка на инсталацията
Независимо от използвания метод, винаги завършвайте с проверка. Това е единственият начин да разберете дали двоичният файл е наистина достъпен от Вашия shell:
vibe --version
Трябва да видите изведен номера на версията (3.0.4 към 2 ноември 2026 г.; поколението 3.0 е от 19 октомври 2026 г.). Ако командата не е намерена, почти никога причината не е в неуспешна инсталация: това означава, че директорията за инсталация не е във Вашия PATH.
Отстраняване на често срещани проблеми
Командата vibe не е намерена
След инсталация чрез uv, двоичният файл обикновено се намира в ~/.local/bin/. Ако тази директория не е обявена във Вашия PATH, Вашият shell не може да я види. Добавете я във Вашия конфигурационен файл:
# In ~/.bashrc or ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
След това презаредете Вашия shell, за да влезе промяната в сила за текущата сесия:
source ~/.bashrc
# or
source ~/.zshrc
Грешка в кеша при uv
Понякога предишна инсталация оставя повреден кеш, обикновено след прекъсване на мрежата. Тогава инсталацията се проваля с грешка, споменаваща кеша. Стартирайте командата отново, като заобиколите кеша:
uv tool install mistral-vibe --no-cache
Конфликт на Python версията
На машина, където съществуват множество интерпретатори – например системен Python 3.11 и ръчно инсталиран 3.12 – uv може да избере грешния. Изрично принудете целевата версия:
uv tool install mistral-vibe --python python3.12
Тези три ситуации покриват почти всички заседнали инсталации. Направете си навик да стартирате отново vibe --version след всяко поправяне.
Ключови изводи
- Python 3.12+ е единственото техническо предварително изискване
- На Mac/Linux скриптът с
curlе най-бързият метод uv tool installе препоръчителният метод за избягване на конфликти- На Windows предпочитайте WSL за по-добро изживяване
- Проверете инсталацията с
vibe --version