Премини към основното съдържание
Български— Изберете език
Меню

Инсталиране на Mistral Vibe CLI

Урок 2 от 16 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Предварителни изисквания
  2. Инсталиране на Mac и Linux
  3. Инсталиране на Windows
  4. Проверка на инсталацията
  5. Отстраняване на често срещани проблеми
  6. Ключови изводи

Предварителни изисквания

Преди да инсталирате 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