Namestitev Python SDK za Mistral
Na tej strani
Predpogoji
Posodobljeno 2. novembra 2026 — Mistral SDK 3. Ta lekcija je prej obravnavala različico SDK 2 in Python 3.9. Trenutna različica je 3.7.0 (izdana 1. novembra 2026); zahteva Python 3.10 ali novejši, od različice 2.0 (marec 2026) pa se odjemalec uvozi z ukazom
from mistralai.client import Mistral. Viri: mistralai na PyPI · opombe ob izdaji v2.0.0 · opombe ob izdaji v3.0.0.
Namestitev SDK zahteva tri stvari: Python 3.10 ali novejši, kar preveriš z python --version; posodobljen pip, ki ga dobiš z pip install --upgrade pip; in tvoj ključ API za Mistral, ki je že nastavljen kot okoljska spremenljivka, kot smo obravnavali v prejšnji lekciji. Če Python še ni nameščen na tvojem računalniku, prenosi najnovejšo stabilno različico s strani python.org ali uporabi upravitelja paketov svojega sistema.
Pred namestitvijo karkoli izoliraj svoj projekt
Vedno delaj znotraj virtualnega okolja. Ta navada te reši pred pogosto težavo: dva projekta na istem računalniku, kjer eden zahteva določeno različico SDK, drugi pa drugo, pri čemer en sam ukaz pip install tiho pokvari prvi projekt z posodobitvijo drugega. Virtualno okolje vsakemu projektu zagotovi lastne izolirane odvisnosti, ločene od sistemskih paketov.
# Ustvari virtualno okolje
python -m venv mistral-env
# Aktiviraj v Linuxu / macOS
source mistral-env/bin/activate
# Aktiviraj v Windowsih
mistral-env\Scripts\activate
Ko je okolje aktivirano, bo ukazna vrstica v terminalu opremljena z imenom okolja v oklepajih: (mistral-env). Ta majhen označevalec zagotavlja, da se naslednji ukazi nanašajo na pravo lokacijo – če se ne prikaže, ne nameščaj ničesar.
Namesti uradni SDK
Namestitev SDK za Mistral zahteva le en ukaz:
pip install mistralai
To namesti najnovejšo različico SDK: 3.7.0 na dan 1. novembra 2026. Generacija 3 se je začela z različico 3.0, izdano 28. septembra 2026. Da potrdiš, da je vse na mestu, zaženi pip show mistralai, da prikažeš ime paketa, različico in odvisnosti.
Včasih projekt zahteva določeno različico, na primer za usklajevanje celotne ekipe med selitvijo. Omejitve lahko določiš na dveh ravneh:
# Ostani znotraj generacije 3
pip install "mistralai>=3,<4"
# Namesti točno določeno različico
pip install "mistralai==3.7.0"
Med postopkom pip potegne nekaj odvisnosti, ki se pojavijo na seznamu. Koristno jih je prepoznati, zlasti httpx2, HTTP odjemalec, ki upravlja omrežne klice (SDK ga uporablja namesto httpx od različice 3.0 naprej), in pydantic, ki validira in serializira izmenjane podatke. S temi ne boš neposredno komuniciral, vendar njihova prisotnost pojasnjuje, zakaj namestitev, ki se zdi majhna, vseeno zavzame nekaj megabajtov.
Preveri namestitev z dejanskim klicem API
Zagon ukaza pip show dokaže, da paket obstaja, ne pa tudi, da tvoja konfiguracija deluje. Pravi test poizveduje po API-ju. Ustvari datoteko z imenom 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!")
# Izpiši razpoložljive modele
models = client.models.list()
print(f"Available models: {len(models.data)}")
for model in models.data[:5]:
print(f" - {model.id}")
Nato jo zaženi:
python test_mistral.py
Ta skript preveri dve stvari hkrati. Preverjanje api_key takoj razlikuje med manjkajočo okoljsko spremenljivko in dejansko omrežno težavo – brez tega bi lahko deset minut sumil na svoj požarni zid, medtem ko je bil terminal preprosto znova odprt brez spremenljivke. Če se seznam modelov prikaže, je SDK pravilno nameščen in tvoj ključ sprejet s strani API-ja.
Zagotovi ponovljivost okolja
Pri timskem projektu mora biti namestitev ponovljiva. Zamrzni svoje odvisnosti:
pip freeze > requirements.txt
Tvoji kolegi lahko nato z enim samim ukazom rekonstruirajo popolnoma enako okolje:
pip install -r requirements.txt
To datoteko bo bral tudi tvoj strežnik za uvajanje. Navadi se, da jo ponovno ustvariš vsakič, ko dodaš knjižnico; v nasprotnem primeru bo koda delovala na tvojem računalniku in nikjer drugje.
Štiri pogoste napake in kako jih diagnosticirati
Napaka ModuleNotFoundError: No module named mistralai skoraj vedno pomeni, da terminal ne uporablja pravilnega virtualnega okolja. To preveri z which python, ki mora kazati na tvoje venv, in nato z pip list | grep mistralai.
Napaka ImportError: cannot import name 'Mistral' from 'mistralai' kaže na kodo, napisano za različico SDK 1. Od različice 2.0 naprej vsi uvozi potekajo preko mistralai.client: zapiši from mistralai.client import Mistral. Lekcija o različicah SDK podrobneje opisuje druge spremembe.
Napaka SSL ali omrežna napaka pogosto razkriva korporacijski posredniški strežnik (proxy), ki sedi med tabo in zunanjim svetom. Pipu ga eksplicitno sporoči:
pip install mistralai --proxy http://proxy.entreprise.com:8080
Končno, če namestitev zavrne tvojo različico Pythona, se spomni, da SDK od različice 2.0 naprej zahteva vsaj Python 3.10. Posodobi Python ali namesti pyenv, da lahko vzporedno poganjaš več različic, ne da bi se dotaknil sistemskega tolmača.
Ključne ugotovitve
- Namesti SDK z
pip install mistralaiznotraj virtualnega okolja - Trenutna različica je 3.7.0 (1. november 2026); odjemalca uvozi z
from mistralai.client import Mistral - Preveri namestitev z izpisom razpoložljivih modelov
- Zamrzni odvisnosti v
requirements.txtza ponovljivost - Zahtevan je Python 3.10 ali novejši