Installja l-SDK ta' Mistral għal Python
F'din il-paġna
Prerekwiżiti
Aġġornat fit-2 ta’ Novembru, 2026 — Mistral SDK 3. Din il-lezzjoni kienet tkopri qabel il-verżjoni 2 tal-SDK u Python 3.9. Il-verżjoni attwali hija 3.7.0 (maħruġa fl-1 ta’ Novembru, 2026); teħtieġ Python 3.10 jew ogħla, u l-klijent jiġi importat permezz ta’
from mistralai.client import Mistralmill-verżjoni 2.0 ‘l quddiem (Marzu 2026). Sorsi: mistralai fuq PyPI · Noti tar-rilaxx v2.0.0 · Noti tar-rilaxx v3.0.0.
L-installazzjoni tal-SDK teħtieġ tliet affarijiet: Python 3.10 jew ogħla, li tista’ tivverifika b’python --version; pip aġġornat, miksub permezz ta’ pip install --upgrade pip; u ċ-ċavetta tal-API ta’ Mistral tiegħek diġà stabbilita bħala varjabbli tal-ambjent, kif kopert fil-lezzjoni preċedenti. Jekk Python mhux installat fuq il-magna tiegħek għadha, niżżel l-aħħar rilaxx stabbli minn python.org jew uża l-maniġer tal-pakketti tas-sistema tiegħek.
Iżola l-proġett tiegħek qabel ma tinstalla xejn
Dejjem aħdem ġo ambjent virtwali. Din l-abitudni ssavvak minn uġigħ ta’ ras komuni: żewġ proġetti fuq l-istess magna, wieħed jeħtieġ verżjoni speċifika tal-SDK u l-ieħor waħda differenti, fejn pip install waħda tikser silenzjożament l-ewwel proġett billi taġġorna t-tieni. Ambjent virtwali jagħti lil kull proġett id-dipendenzi iżolati tiegħu stess, separati mill-pakketti tas-sistema kollha kemm hi.
# Oħloq l-ambjent virtwali
python -m venv mistral-env
# Attiva fuq Linux / macOS
source mistral-env/bin/activate
# Attiva fuq Windows
mistral-env\Scripts\activate
Ladarba attivata, il-prompt tat-terminal tiegħek ikun prefissat bl-isem tal-ambjent f’parentesi: (mistral-env). Dan il-markatur żgħur jiggarantixxi li l-kmandi sussegwenti japplikaw għall-post it-tajjeb—jekk ma jidhirx, tinstalla xejn.
Installa l-SDK uffiċjali
L-installazzjoni tal-Mistral SDK tieħu kmand wieħed biss:
pip install mistralai
Dan jinstalla l-aħħar verżjoni tal-SDK: 3.7.0 mill-1 ta’ Novembru, 2026. Il-Ġenerazzjoni 3 bdiet bil-verżjoni 3.0, maħruġa fit-28 ta’ Settembru, 2026. Biex tikkonferma li kollox huwa fil-post, ħaddem pip show mistralai biex turi l-isem tal-pakkett, il-verżjoni, u d-dipendenzi.
Xi kultant proġett jeħtieġ verżjoni speċifika, pereżempju, biex iżomm tim sħiħ allinjat waqt migrazzjoni. Tista’ tispeċifika restrizzjonijiet f’żewġ livelli:
# Ibqa' fil-ġenerazzjoni 3
pip install "mistralai>=3,<4"
# Installa verżjoni eżatta
pip install "mistralai==3.7.0"
Matul it-triq, pip jiġbed ftit dipendenzi li jidhru fil-lista. Jgħin li tirrikonoxxihom, partikolarment httpx2, il-klijent HTTP li jimmaniġġja s-sejħiet tan-netwerk (l-SDK juża dan minflok httpx mill-verżjoni 3.0 ‘l quddiem), u pydantic, li jvalida u jissirjalizza d-data skambjata. Mhux se tinteraġixxi magħhom direttament, iżda l-preżenza tagħhom tispjega għaliex installazzjoni li tidher żgħira xorta tokkupa ftit megabytes.
Ivverifika l-installazzjoni b’sejħa reali tal-API
Li tħaddem pip show jipprova li l-pakkett jeżisti, mhux li l-konfigurazzjoni tiegħek taħdem. It-test reali jistaqsi lill-API. Oħloq fajl imsejjaħ 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!")
# Elenska l-mudelli disponibbli
models = client.models.list()
print(f"Available models: {len(models.data)}")
for model in models.data[:5]:
print(f" - {model.id}")
Imbagħad ħaddmu:
python test_mistral.py
Dan l-iskript jiċċekkja żewġ affarijiet f’daqqa. Iċ-ċekk fuq api_key jiddistingwi immedjatament varjabbli tal-ambjent nieqsa minn problema ġenwina tan-netwerk—mingħajru, tista’ tonfoq għaxar minuti ssuspetta l-firewall tiegħek meta t-terminal kien sempliċiment infetaħ mill-ġdid mingħajr il-varjabbli. Jekk il-lista tal-mudelli tidher, l-SDK huwa installat korrettament u ċ-ċavetta tiegħek hija aċċettata mill-API.
Agħmel l-ambjent riproduċibbli
Fuq proġett ta’ tim, l-installazzjoni trid tkun riproduċibbli. Iffriża d-dipendenzi tiegħek:
pip freeze > requirements.txt
Il-kollegi tiegħek imbagħad jistgħu jerġgħu jibnu l-istess ambjent eżatt b’kmand wieħed:
pip install -r requirements.txt
Is-server tad-distribuzzjoni tiegħek jaqra dan il-fajl ukoll. Ħu l-abitudni li terġa’ tiġġenerah kull darba li żżid librerija; inkella, il-kodiċi se jaħdem fuq il-magna tiegħek u mkien ieħor.
Erba’ fallimenti komuni u kif tiddijanostikahom
L-iżball ModuleNotFoundError: No module named mistralai kważi dejjem ifisser li t-terminal mhux qed juża l-ambjent virtwali korrett. Ivverifika dan b’which python, li għandu jipponta lejn il-venv tiegħek, u mbagħad b’pip list | grep mistralai.
L-iżball ImportError: cannot import name 'Mistral' from 'mistralai' jindika kodiċi miktub għall-verżjoni 1 tal-SDK. Mill-verżjoni 2.0, l-importazzjonijiet kollha jgħaddu minn mistralai.client: ikteb from mistralai.client import Mistral. Il-lezzjoni dwar il-verżjonijiet tal-SDK tiddettalja bidliet oħra.
Żball SSL jew tan-netwerk spiss jiżvela proxy korporattiv bilqiegħda bejnek u d-dinja ta’ barra. Għid lil pip dwaru b’mod espliċitu:
pip install mistralai --proxy http://proxy.entreprise.com:8080
Fl-aħħar nett, jekk l-installazzjoni tirrifjuta l-verżjoni ta’ Python tiegħek, ftakar li l-SDK kien jeħtieġ Python 3.10 bħala minimu mill-verżjoni 2.0. Aġġorna Python, jew installa pyenv biex tħaddem verżjonijiet multipli ħdejn xulxin mingħajr ma tmiss l-interpreta tas-sistema.
Punti Ewlenin
- Installa l-SDK b’
pip install mistralaiġo ambjent virtwali - Il-verżjoni attwali hija 3.7.0 (1 ta’ Novembru, 2026); importja l-klijent permezz ta’
from mistralai.client import Mistral - Ivverifika l-installazzjoni billi telenska l-mudelli disponibbli
- Iffriża d-dipendenzi f’
requirements.txtgħar-riproduċibbiltà - Python 3.10 jew ogħla huwa meħtieġ