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

Инсталиране на Mistral Python SDK

Урок 4 от 14 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Предварителни изисквания
  2. Изолирайте проекта си, преди да инсталирате каквото и да е
  3. Инсталирайте официалното SDK
  4. Проверете инсталацията с реално API обаждане
  5. Направете средата възпроизводима
  6. Четири често срещани грешки и как да ги диагностицирате
  7. Ключови изводи

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

Обновено на 2 ноември 2026 г. — Mistral SDK 3. Този урок преди това обхващаше версия 2 на SDK и Python 3.9. Текущата версия е 3.7.0 (пусната на 1 ноември 2026 г.); тя изисква Python 3.10 или по-нова версия, а клиентът се импортира чрез from mistralai.client import Mistral считано от версия 2.0 (март 2026 г.). Източници: mistralai в PyPI · Бележки към версия v2.0.0 · Бележки към версия v3.0.0.

Инсталирането на SDK изисква три неща: Python 3.10 или по-нова версия, което можете да проверите с python --version; актуален pip, получен чрез pip install --upgrade pip; и вашият API ключ на Mistral, вече зададен като променлива на средата, както беше разгледано в предишния урок. Ако Python все още не е инсталиран на вашата машина, изтеглете най-новата стабилна версия от python.org или използвайте мениджъра на пакети на вашата система.

Изолирайте проекта си, преди да инсталирате каквото и да е

Винаги работете във виртуална среда. Този навик ви спасява от често срещан главоболие: два проекта на една и съща машина, единият изискващ конкретна версия на SDK, а другият – различна, където едно единствено pip install тихо нарушава първия проект, като актуализира втория. Виртуалната среда предоставя на всеки проект собствени изолирани зависимости, отделни от системните ви пакети.

# Създаване на виртуалната среда
python -m venv mistral-env

# Активиране в Linux / macOS
source mistral-env/bin/activate

# Активиране в Windows
mistral-env\Scripts\activate

След активиране, подканата на терминала ви ще бъде префиксирана с името на средата в скоби: (mistral-env). Този малък маркер гарантира, че последващите команди се прилагат към правилното местоположение – ако не се появи, не инсталирайте нищо.

Инсталирайте официалното SDK

Инсталирането на Mistral SDK отнема само една команда:

pip install mistralai

Това инсталира най-новата версия на SDK: 3.7.0 към 1 ноември 2026 г. Поколение 3 започна с версия 3.0, пусната на 28 септември 2026 г. За да потвърдите, че всичко е на място, изпълнете pip show mistralai, за да покажете името на пакета, версията и зависимостите.

Понякога даден проект изисква конкретна версия, например, за да се поддържа целият екип синхронизиран по време на миграция. Можете да посочите ограничения на две нива:

# Оставане в рамките на поколение 3
pip install "mistralai>=3,<4"

# Инсталиране на точна версия
pip install "mistralai==3.7.0"

По пътя си pip изтегля няколко зависимости, които се появяват в списъка. Полезно е да ги разпознаете, особено httpx2 – HTTP клиентът, обработващ мрежовите обаждания (SDK използва това вместо httpx считано от версия 3.0), и pydantic, който валидира и сериализира обменените данни. Няма да взаимодействате директно с тях, но тяхното присъствие обяснява защо инсталация, която изглежда малка, все пак заема няколко мегабайта.

Проверете инсталацията с реално API обаждане

Изпълнението на pip show доказва, че пакетът съществува, но не и че конфигурацията ви работи. Истинският тест прави заявка към API. Създайте файл с име test_mistral.py:

import os
from mistralai.client import Mistral

api_key = os.environ.get("MISTRAL_API_KEY")

if not api_key:
    print("Error: MISTRAL_API_KEY environment variable is not set.")
else:
    client = Mistral(api_key=api_key)
    print("Mistral client initialized successfully!")

    # Списък с наличните модели
    models = client.models.list()
    print(f"Available models: {len(models.data)}")
    for model in models.data[:5]:
        print(f"  - {model.id}")

След това го изпълнете:

python test_mistral.py

Този скрипт проверява две неща едновременно. Проверката на api_key веднага разграничава липсваща променлива на средата от истински мрежов проблем – без нея може да прекарате десет минути, подозирайки защитната си стена, докато терминалът просто е бил отворен отново без променливата. Ако списъкът с модели се покаже, SDK е инсталиран правилно и вашият ключ е приет от API.

Направете средата възпроизводима

При проект в екип инсталацията трябва да бъде възпроизводима. Фиксирайте зависимостите си:

pip freeze > requirements.txt

Вашите колеги след това могат да възстановят точно същата среда с една команда:

pip install -r requirements.txt

Вашият сървър за внедряване също ще прочете този файл. Придобийте навика да го регенерирате всеки път, когато добавяте библиотека; в противен случай кодът ще работи на вашата машина и никъде другаде.

Четири често срещани грешки и как да ги диагностицирате

Грешката ModuleNotFoundError: No module named mistralai почти винаги означава, че терминалът не използва правилната виртуална среда. Проверете това с which python, което трябва да сочи към вашата venv, и след това с pip list | grep mistralai.

Грешката ImportError: cannot import name 'Mistral' from 'mistralai' показва код, написан за SDK версия 1. От версия 2.0 нататък всички импорти минават през mistralai.client: напишете from mistralai.client import Mistral. Урокът за версиите на SDK описва други промени.

SSL или мрежова грешка често разкрива корпоративен прокси сървър, разположен между вас и външния свят. Изрично уведомете pip за него:

pip install mistralai --proxy http://proxy.entreprise.com:8080

И накрая, ако инсталацията отхвърли вашата версия на Python, помнете, че SDK изисква минимум Python 3.10 от версия 2.0 насам. Актуализирайте Python или инсталирайте pyenv, за да стартирате множество версии една до друга, без да засягате системния интерпретатор.

Ключови изводи

  • Инсталирайте SDK с pip install mistralai във виртуална среда
  • Текущата версия е 3.7.0 (1 ноември 2026 г.); импортирайте клиента чрез from mistralai.client import Mistral
  • Проверете инсталацията, като изброите наличните модели
  • Фиксирайте зависимостите във requirements.txt за възпроизводимост
  • Изисква се Python 3.10 или по-нова версия