Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Namestitev Python SDK za Mistral

Lekcija 4 od 14 Posodobljeno 2. november 2026 Razvijalec
Na tej strani
  1. Predpogoji
  2. Pred namestitvijo karkoli izoliraj svoj projekt
  3. Namesti uradni SDK
  4. Preveri namestitev z dejanskim klicem API
  5. Zagotovi ponovljivost okolja
  6. Štiri pogoste napake in kako jih diagnosticirati
  7. Ključne ugotovitve

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 mistralai znotraj 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.txt za ponovljivost
  • Zahtevan je Python 3.10 ali novejši