A Mistral Python SDK telepítése
Ezen az oldalon
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 Mistralutasí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 mistralaiparanccsal egy virtuális környezetben - A jelenlegi verzió a 3.7.0 (2026. november 1.); a klienst a
from mistralai.client import Mistralutasí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.txtfájlba a reprodukálhatóság érdekében - Python 3.10 vagy újabb szükséges