Mistrali Pythoni SDK installimine
Sellel lehel
Eeldused
Uuendatud 2. novembril 2026 – Mistrali SDK 3. See õppetund käsitles varem SDK versiooni 2 ja Pythoni 3.9. Praegune versioon on 3.7.0 (avaldatud 1. novembril 2026); see nõuab Pythoni 3.10 või uuemat ning kliendi imporditakse alates versioonist 2.0 (märts 2026) käsuga
from mistralai.client import Mistral. Allikad: mistralai PyPI-s · v2.0.0 väljalaskemärkmed · v3.0.0 väljalaskemärkmed.
SDK installimiseks on vaja kolme asja: Python 3.10 või uuem, mille saad kontrollida käsuga python --version; ajakohane pip, mille saad käsuga pip install --upgrade pip; ja sinu Mistrali API võti, mis peab olema juba keskkonnamuutujana seatud, nagu eelmises õppetunnis käsitleti. Kui Pythonit sinu masinas veel pole, laadi alla viimane stabiilne versioon saidilt python.org või kasuta oma süsteemi paketihaldurit.
Isoleeri oma projekt enne installimist
Tööta alati virtuaalses keskkonnas. See harjumus hoiab sind ära levinud peavalust: kaks projekti samal masinal, kus üks nõuab kindlat SDK versiooni ja teine teistsugust, ning üksainus pip install rikub vaikimisi esimese projekti, uuendades teist. Virtuaalne keskkond annab igale projektile oma isoleeritud sõltuvused, eraldatuna süsteemiülestest pakettidest.
# Loo virtuaalne keskkond
python -m venv mistral-env
# Aktiveeri Linuxil / macOS-is
source mistral-env/bin/activate
# Aktiveeri Windowsis
mistral-env\Scripts\activate
Kui keskkond on aktiveeritud, eelneb sinu terminali viibale keskkonna nimi sulgudes: (mistral-env). See väike marker garanteerib, et järgnevad käsud rakenduvad õiges asukohas – kui seda ei ilmu, ära installi midagi.
Installi ametlik SDK
Mistrali SDK installimiseks piisab ühest käsust:
pip install mistralai
See installib SDK viimase versiooni: 3.7.0 seisuga 1. november 2026. 3. põlvkond algas versiooniga 3.0, mis anti välja 28. septembril 2026. Et veenduda, et kõik on korras, käivita pip show mistralai, et kuvada paketi nimi, versioon ja sõltuvused.
Mõnikord nõuab projekt kindlat versiooni, näiteks selleks, et hoida kogu meeskond migratsiooni ajal joonel. Saad määrata piirangud kahel tasandil:
# Püsi 3. põlvkonna sees
pip install "mistralai>=3,<4"
# Installi täpne versioon
pip install "mistralai==3.7.0"
Selle käigus toob pip kaasa mõned sõltuvused, mis ilmuvad nimekirja. Kasulik on neid tunda, eriti httpx2 – HTTP-klient, mis haldab võrgukõnesid (SDK kasutab seda alates versioonist 3.0 httpx asemel) – ja pydantic, mis valideerib ja serialiseerib vahetatavaid andmeid. Sa nendega otseselt ei suhtle, kuid nende olemasolu selgitab, miks esmapilgul väike installatsioon võtab siiski paar megabaiti ruumi.
Kontrolli installimist reaalse API päringuga
pip show käivitamine tõestab ainult paketi olemasolu, mitte seda, et sinu konfiguratsioon töötab. Tegelik test küsib andmeid API-lt. Loo fail nimega 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!")
# Loetle saadaolevad mudelid
models = client.models.list()
print(f"Available models: {len(models.data)}")
for model in models.data[:5]:
print(f" - {model.id}")
Seejärel käivita see:
python test_mistral.py
See skript kontrollib korraga kahte asja. Kontroll api_key üle eristab koheselt puuduva keskkonnamuutuja tegelikust võrguprobleemist – ilma selleta võid veeta kümme minutit kahtlustades tulemüüri, kuigi terminal lihtsalt avati uuesti ilma muutujata. Kui mudelite loend kuvatakse, on SDK korrektselt installitud ja sinu võti on API poolt aktsepteeritud.
Muuda keskkond reprodutseeritavaks
Meeskonnaprojekti puhul peab installimine olema reprodutseeritav. Külmuta oma sõltuvused:
pip freeze > requirements.txt
Sinu kolleegid saavad seejärel täpselt sama keskkonna taastada ühe käsuga:
pip install -r requirements.txt
Sinu juurutusserver loeb samuti seda faili. Harjuta end iga raamatukogu lisamisel seda uuesti genereerima; vastasel juhul töötab kood ainult sinu masinas ja mitte kusagil mujal.
Neli levinud tõrget ja nende diagnoosimine
Viga ModuleNotFoundError: No module named mistralai tähendab peaaegu alati, et terminal ei kasuta õiget virtuaalset keskkonda. Kontrolli seda käsuga which python, mis peaks osutama sinu venv-ile, ja seejärel käsuga pip list | grep mistralai.
Viga ImportError: cannot import name 'Mistral' from 'mistralai' viitab SDK 1. versioonile kirjutatud koodile. Alates versioonist 2.0 imporditakse kõik läbi mistralai.client: kirjuta from mistralai.client import Mistral. SDK versioonide õppetund kirjeldab muid muudatusi.
SSL-i või võrguviga paljastab sageli ettevõtte proksi, mis asub sinu ja välismaailma vahel. Tea pipile seda sõnaselgelt:
pip install mistralai --proxy http://proxy.entreprise.com:8080
Lõpuks, kui installimine lükkab sinu Pythoni versiooni tagasi, pea meeles, et SDK on alates versioonist 2.0 nõudnud vähemalt Pythoni 3.10. Uuenda Pythonit või installi pyenv, et käivitada mitut versiooni kõrvuti, puutumata süsteemi interpretaatorit.
Peamised punktid
- Installi SDK käsuga
pip install mistralaivirtuaalses keskkonnas - Praegune versioon on 3.7.0 (1. november 2026); impordi klient käsuga
from mistralai.client import Mistral - Kontrolli installimist, loetledes saadaolevad mudelid
- Külmuta sõltuvused faili
requirements.txtreprodutseeritavuse tagamiseks - Nõutav on Python 3.10 või uuem