Przejdź do głównej treści
Polski— Wybierz język
Menu

Instalacja Python SDK Mistral

Lekcja 4 z 14 Zaktualizowano 2 listopada 2026 Programista
Na tej stronie
  1. Wymagania wstępne
  2. Izoluj projekt przed instalacją czegokolwiek
  3. Zainstaluj oficjalne SDK
  4. Zweryfikuj instalację rzeczywistym wywołaniem API
  5. Zapewnij powtarzalność środowiska
  6. Cztery typowe błędy i sposób ich diagnozowania
  7. Kluczowe wnioski

Wymagania wstępne

Aktualizacja z 2 listopada 2026 — Mistral SDK 3. Lekcja ta wcześniej omawiała wersję 2 SDK i Pythona 3.9. Obecna wersja to 3.7.0 (wydana 1 listopada 2026); wymaga Pythona 3.10 lub nowszego, a klient jest importowany poprzez from mistralai.client import Mistral począwszy od wersji 2.0 (marzec 2026). Źródła: mistralai on PyPI · v2.0.0 release notes · v3.0.0 release notes.

Instalacja SDK wymaga trzech rzeczy: Pythona 3.10 lub nowszego, co możesz zweryfikować poleceniem python --version; aktualnego menedżera pip, który uzyskasz przez pip install --upgrade pip; oraz Twojego klucza API Mistral, już ustawionego jako zmienna środowiskowa, zgodnie z poprzednią lekcją. Jeśli Python nie jest jeszcze zainstalowany na Twojej maszynie, pobierz najnowszą stabilną wersję ze strony python.org lub użyj menedżera pakietów swojego systemu.

Izoluj projekt przed instalacją czegokolwiek

Zawsze pracuj wewnątrz środowiska wirtualnego. Ten nawyk uchroni Cię przed częstym bólem głowy: dwa projekty na tej samej maszynie, z których jeden wymaga konkretnej wersji SDK, a drugi innej, gdzie pojedyncze pip install po cichu psuje pierwszy projekt, aktualizując drugi. Środowisko wirtualne zapewnia każdemu projektowi własne, izolowane zależności, oddzielone od pakietów systemowych.

# Utwórz środowisko wirtualne
python -m venv mistral-env

# Aktywuj w systemie Linux / macOS
source mistral-env/bin/activate

# Aktywuj w systemie Windows
mistral-env\Scripts\activate

Po aktywacji znak zachęty w terminalu zostanie poprzedzony nazwą środowiska w nawiasach: (mistral-env). Ten mały znacznik gwarantuje, że kolejne polecenia zostaną zastosowane we właściwym miejscu – jeśli się nie pojawi, nic nie instaluj.

Zainstaluj oficjalne SDK

Instalacja Mistral SDK wymaga tylko jednego polecenia:

pip install mistralai

Polecenie to instaluje najnowszą wersję SDK: 3.7.0 według stanu na 1 listopada 2026. Generacja 3 rozpoczęła się wraz z wersją 3.0, wydaną 28 września 2026. Aby potwierdzić, że wszystko jest na miejscu, uruchom pip show mistralai, aby wyświetlić nazwę pakietu, wersję i zależności.

Czasami projekt wymaga konkretnej wersji, na przykład aby utrzymać spójność całego zespołu podczas migracji. Możesz określić ograniczenia na dwóch poziomach:

# Pozostań w obrębie generacji 3
pip install "mistralai>=3,<4"

# Zainstaluj dokładną wersję
pip install "mistralai==3.7.0"

Podczas tego procesu pip pobiera kilka zależności, które pojawiają się na liście. Warto je rozpoznać, w szczególności httpx2 – klienta HTTP obsługującego wywołania sieciowe (SDK używa go zamiast httpx począwszy od wersji 3.0) oraz pydantic, który waliduje i serializuje wymieniane dane. Nie będziesz wchodzić z nimi w bezpośrednią interakcję, ale ich obecność wyjaśnia, dlaczego instalacja, która wydaje się maleńka, zajmuje jednak kilka megabajtów.

Zweryfikuj instalację rzeczywistym wywołaniem API

Uruchomienie pip show dowodzi jedynie istnienia pakietu, a nie poprawności konfiguracji. Prawdziwym testem jest zapytanie do API. Utwórz plik o nazwie 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!")

    # Lista dostępnych modeli
    models = client.models.list()
    print(f"Available models: {len(models.data)}")
    for model in models.data[:5]:
        print(f"  - {model.id}")

Następnie uruchom go:

python test_mistral.py

Ten skrypt sprawdza dwie rzeczy naraz. Sprawdzenie zmiennej api_key natychmiast odróżnia brakującą zmienną środowiskową od rzeczywistego problemu z siecią – bez niego możesz spędzić dziesięć minut, podejrzewając swoją zaporę ogniową, gdy tymczasem terminal został po prostu ponownie otwarty bez tej zmiennej. Jeśli lista modeli się wyświetli, oznacza to, że SDK jest poprawnie zainstalowane, a Twój klucz został zaakceptowany przez API.

Zapewnij powtarzalność środowiska

W projekcie zespołowym instalacja musi być powtarzalna. Zamroź swoje zależności:

pip freeze > requirements.txt

Twoi koledzy będą mogli następnie odtworzyć dokładnie takie samo środowisko jednym poleceniem:

pip install -r requirements.txt

Twój serwer wdrożeniowy również odczyta ten plik. Wyrób w sobie nawyk regenerowania go za każdym razem, gdy dodajesz bibliotekę; w przeciwnym razie kod będzie działał na Twojej maszynie i nigdzie indziej.

Cztery typowe błędy i sposób ich diagnozowania

Błąd ModuleNotFoundError: No module named mistralai prawie zawsze oznacza, że terminal nie używa właściwego środowiska wirtualnego. Zweryfikuj to poleceniem which python, które powinno wskazywać na Twój venv, a następnie pip list | grep mistralai.

Błąd ImportError: cannot import name 'Mistral' from 'mistralai' wskazuje na kod napisany dla wersji 1 SDK. Od wersji 2.0 wszystkie importy przechodzą przez mistralai.client: zapisz from mistralai.client import Mistral. Lekcja dotycząca wersji SDK szczegółowo opisuje inne zmiany.

Błąd SSL lub sieciowy często ujawnia obecność firmowego proxy siedzącego między Tobą a światem zewnętrznym. Poinformuj o nim pip w sposób jawny:

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

Na koniec, jeśli instalacja odrzuci Twoją wersję Pythona, pamiętaj, że SDK wymaga Pythona 3.10 jako minimum od wersji 2.0. Zaktualizuj Pythona lub zainstaluj pyenv, aby uruchamiać wiele wersji obok siebie bez dotykania interpretera systemowego.

Kluczowe wnioski

  • Zainstaluj SDK poleceniem pip install mistralai wewnątrz środowiska wirtualnego
  • Obecna wersja to 3.7.0 (1 listopada 2026); importuj klienta przez from mistralai.client import Mistral
  • Zweryfikuj instalację, wyświetlając listę dostępnych modeli
  • Zamroź zależności w pliku requirements.txt dla zapewnienia powtarzalności
  • Wymagany jest Python 3.10 lub nowszy