Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

A Mistral Python SDK telepítése

4. lecke 14 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Előfeltételek
  2. Izoláld a projektedet bármi telepítése előtt
  3. A hivatalos SDK telepítése
  4. A telepítés ellenőrzése valós API-hívással
  5. Tedd reprodukálhatóvá a környezetet
  6. Négy gyakori hiba és a diagnosztizálásuk
  7. Főbb megállapítások

Előfeltételek

Frissítve: 2026. november 2. — Mistral SDK 3. Ez a lecke korábban az SDK 2-es verzióját és a Python 3.9-et tárgyalta. A jelenlegi verzió a 3.7.0 (megjelenés: 2026. november 1.); ehhez Python 3.10 vagy újabb szükséges, és a klienst a 2.0-s verziótól (2026. március) kezdve a from mistralai.client import Mistral utasítással importálod. Források: mistralai a PyPI-n · v2.0.0 kiadási jegyzetek · v3.0.0 kiadási jegyzetek.

Az SDK telepítéséhez három dologra van szükséged: Python 3.10 vagy újabb, amit a python --version paranccsal ellenőrizhetsz; egy naprakész pip, amit a pip install --upgrade pip paranccsal érsz el; valamint a Mistral API kulcsod, amelyet környezeti változóként már beállítottál az előző leckében. Ha még nincs Python telepítve a gépedre, töltsd le a legfrissebb stabil kiadást a python.org oldalról, vagy használd a rendszered csomagkezelőjét.

Izoláld a projektedet bármi telepítése előtt

Mindig virtuális környezetben dolgozz. Ez a szokás megkímél egy gyakori fejfájástól: két projekt ugyanazon a gépen, ahol az egyik egy adott SDK-verziót igényel, a másik pedig egy másikat, és egyetlen pip install parancs csendben tönkreteszi az első projektet a második frissítésével. A virtuális környezet minden projekt számára saját, izolált függőségeket biztosít, elkülönítve a rendszer szintű csomagoktól.

# Virtuális környezet létrehozása
python -m venv mistral-env

# Aktiválás Linux / macOS rendszeren
source mistral-env/bin/activate

# Aktiválás Windows rendszeren
mistral-env\Scripts\activate

Ha aktiváltad a környezetet, a terminál promptja előtt megjelenik a környezet neve zárójelben: (mistral-env). Ez a kis jelző garantálja, hogy a következő parancsok a megfelelő helyre vonatkoznak – ha nem jelenik meg, ne telepíts semmit.

A hivatalos SDK telepítése

A Mistral SDK telepítése egyetlen parancsot igényel:

pip install mistralai

Ez telepíti az SDK legfrissebb verzióját: 3.7.0 (2026. november 1. állapot szerint). A 3-as generáció a 3.0-s verzióval kezdődött, amelyet 2026. szeptember 28-án adtak ki. Annak ellenőrzésére, hogy minden a helyén van, futtasd a pip show mistralai parancsot, amely megjeleníti a csomag nevét, verzióját és függőségeit.

Néha egy projektnek specifikus verzióra van szüksége, például azért, hogy egy migráció során az egész csapat egységes maradjon. Két szinten is megadhatsz korlátozásokat:

# Maradj a 3-as generáción belül
pip install "mistralai>=3,<4"

# Egy pontos verzió telepítése
pip install "mistralai==3.7.0"

Eközben a pip behúz néhány függőséget, amelyek megjelennek a listában. Hasznos felismerni ezeket, különösen a httpx2-t, amely a hálózati hívásokat kezelő HTTP-kliens (az SDK a 3.0-s verziótól ezt használja az httpx helyett), valamint a pydantic-ot, amely validálja és szerializálja a cserélt adatokat. Közvetlenül nem fogsz ezekkel dolgozni, de jelenlétük megmagyarázza, miért foglal el néhány megabájtot egy aprónak tűnő telepítés.

A telepítés ellenőrzése valós API-hívással

A pip show futtatása csak azt bizonyítja, hogy a csomag létezik, azt nem, hogy a konfigurációd működik. Az igazi teszt az API lekérdezése. Hozz létre egy test_mistral.py nevű fájlt:

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!")

    # Elérhető modellek listázása
    models = client.models.list()
    print(f"Available models: {len(models.data)}")
    for model in models.data[:5]:
        print(f"  - {model.id}")

Majd futtasd:

python test_mistral.py

Ez a szkript egyszerre két dolgot ellenőriz. Az api_key ellenőrzése azonnal megkülönbözteti a hiányzó környezeti változót egy valódi hálózati problémától – enélkül akár tíz percet is eltölthetsz a tűzfalad gyanúsításával, miközben a terminált egyszerűen csak a változó nélkül nyitottad meg újra. Ha megjelenik a modelllista, az SDK helyesen van telepítve, és a kulcsodat az API elfogadta.

Tedd reprodukálhatóvá a környezetet

Egy csapatprojektben a telepítésnek reprodukálhatónak kell lennie. Fagyaszd le a függőségeidet:

pip freeze > requirements.txt

Kollégáid ezután egyetlen paranccsal pontosan ugyanazt a környezetet állíthatják helyre:

pip install -r requirements.txt

A telepítési szervered is ezt a fájlt fogja olvasni. Szokd rá magad, hogy minden egyes könyvtár hozzáadásakor újra generálod ezt a fájlt; ellenkező esetben a kód csak a te gépeden fog működni, máshol sehol.

Négy gyakori hiba és a diagnosztizálásuk

A ModuleNotFoundError: No module named mistralai hiba szinte mindig azt jelenti, hogy a terminál nem a megfelelő virtuális környezetet használja. Ellenőrizd ezt a which python paranccsal, amelynek a venv-edre kell mutatnia, majd a pip list | grep mistralai paranccsal.

Az ImportError: cannot import name 'Mistral' from 'mistralai' hiba azt jelzi, hogy az kód az SDK 1-es verziójához íródott. A 2.0-s verziótól kezdve minden importálás a mistralai.client modulon keresztül történik: írd így: from mistralai.client import Mistral. Az SDK-verziókról szóló lecke részletezi a többi változást.

Egy SSL vagy hálózati hiba gyakran arra utal, hogy egy vállalati proxy ül közted és a külvilág között. Expliciten add meg a pipnek:

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

Végül, ha a telepítés elutasítja a Python-verziódat, ne feledd, hogy az SDK a 2.0-s verzió óta minimum Python 3.10-et igényel. Frissítsd a Pythont, vagy telepítsd a pyenv-t, hogy több verziót fuss egymás mellett a rendszerértelmezett érintése nélkül.

Főbb megállapítások

  • Telepítsd az SDK-t a pip install mistralai paranccsal egy virtuális környezetben
  • A jelenlegi verzió a 3.7.0 (2026. november 1.); a klienst a from mistralai.client import Mistral utasítással importáld
  • Ellenőrizd a telepítést az elérhető modellek listázásával
  • Fagyaszd le a függőségeket a requirements.txt fájlba a reprodukálhatóság érdekében
  • Python 3.10 vagy újabb szükséges