Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Installja l-SDK ta' Mistral għal Python

Lezzjoni 4 / 14 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Prerekwiżiti
  2. Iżola l-proġett tiegħek qabel ma tinstalla xejn
  3. Installa l-SDK uffiċjali
  4. Ivverifika l-installazzjoni b’sejħa reali tal-API
  5. Agħmel l-ambjent riproduċibbli
  6. Erba’ fallimenti komuni u kif tiddijanostikahom
  7. Punti Ewlenin

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 Mistral mill-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.txt għar-riproduċibbiltà
  • Python 3.10 jew ogħla huwa meħtieġ