Salt la conținutul principal
Română— Alege o limbă
Meniu

Instalarea SDK-ului Python Mistral

Lecția 4 din 14 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Condiții prealabile
  2. Izolați proiectul înainte de a instala orice
  3. Instalarea SDK-ului oficial
  4. Verificați instalarea cu un apel API real
  5. Asigurați reproductibilitatea mediului
  6. Patru erori frecvente și cum să le diagnosticați
  7. Puncte cheie

Condiții prealabile

Actualizat pe 2 noiembrie 2026 — Mistral SDK 3. Această lecție acoperea anterior versiunea SDK 2 și Python 3.9. Versiunea curentă este 3.7.0 (lansată pe 1 noiembrie 2026); necesită Python 3.10 sau o versiune superioară, iar clientul se importă prin from mistralai.client import Mistral începând cu versiunea 2.0 (martie 2026). Surse: mistralai on PyPI · v2.0.0 release notes · v3.0.0 release notes.

Instalarea SDK-ului necesită trei elemente: Python 3.10 sau o versiune superioară, pe care le puteți verifica cu python --version; un pip actualizat, obținut prin pip install --upgrade pip; și cheia dvs. API Mistral setată deja ca variabilă de mediu, așa cum s-a detaliat în lecția anterioară. Dacă Python nu este încă instalat pe mașina dvs., descărcați cea mai recentă versiune stabilă de pe python.org sau utilizați managerul de pachete al sistemului dvs.

Izolați proiectul înainte de a instala orice

Lucrați întotdeauna într-un mediu virtual. Acest obicei vă scutește de o problemă frecventă: două proiecte pe aceeași mașină, dintre care unul necesită o versiune specifică a SDK-ului, iar celălalt o versiune diferită, caz în care un singur pip install poate strica silențios primul proiect actualizându-l pe al doilea. Un mediu virtual oferă fiecărui proiect propriile dependențe izolate, separate de pachetele la nivel de sistem.

# Crearea mediului virtual
python -m venv mistral-env

# Activare pe Linux / macOS
source mistral-env/bin/activate

# Activare pe Windows
mistral-env\Scripts\activate

Odată activat, promptul terminalului va fi prefixat cu numele mediului între paranteze: (mistral-env). Acest mic indicator garantează că comenzile ulterioare se aplică locației corecte; dacă nu apare, nu instalați nimic.

Instalarea SDK-ului oficial

Instalarea Mistral SDK necesită o singură comandă:

pip install mistralai

Aceasta instalează cea mai recentă versiune a SDK-ului: 3.7.0 la data de 1 noiembrie 2026. Generația 3 a început cu versiunea 3.0, lansată pe 28 septembrie 2026. Pentru a confirma că totul este în regulă, rulați pip show mistralai pentru a afișa numele pachetului, versiunea și dependențele.

Uneori, un proiect necesită o versiune specifică, de exemplu, pentru a menține o echipă întreagă aliniată în timpul unei migrări. Puteți specifica constrângeri la două niveluri:

# Rămâneți în cadrul generației 3
pip install "mistralai>=3,<4"

# Instalați o versiune exactă
pip install "mistralai==3.7.0"

Pe parcurs, pip preia câteva dependențe care apar în listă. Este util să le recunoașteți, în special httpx2, clientul HTTP care gestionează apelurile de rețea (SDK-ul folosește acest lucru în loc de httpx începând cu versiunea 3.0), și pydantic, care validează și serializează datele schimbate. Nu veți interacționa direct cu acestea, dar prezența lor explică de ce o instalare care pare minusculă ocupă totuși câțiva megaocteți.

Verificați instalarea cu un apel API real

Rularea comenzii pip show dovedește existența pachetului, nu și faptul că configurația dvs. funcționează. Testul real interoghează API-ul. Creați un fișier numit 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!")

    # Listarea modelelor disponibile
    models = client.models.list()
    print(f"Available models: {len(models.data)}")
    for model in models.data[:5]:
        print(f"  - {model.id}")

Apoi rulați-l:

python test_mistral.py

Acest script verifică două lucruri simultan. Verificarea variabilei api_key distinge imediat o variabilă de mediu lipsă de o problemă reală de rețea; fără ea, ați putea petrece zece minute suspectând firewall-ul, când terminalul a fost pur și simplu redeschis fără variabilă. Dacă lista de modele se afișează, SDK-ul este instalat corect, iar cheia dvs. este acceptată de API.

Asigurați reproductibilitatea mediului

Într-un proiect de echipă, instalarea trebuie să fie reproductibilă. Înghețați dependențele:

pip freeze > requirements.txt

Colegii dvs. pot apoi reconstrui exact același mediu cu o singură comandă:

pip install -r requirements.txt

Serverul dvs. de deploy va citi, de asemenea, acest fișier. Obișnuiți-vă să îl regenerați de fiecare dată când adăugați o librărie; altfel, codul va funcționa doar pe mașina dvs. și nicăieri altundeva.

Patru erori frecvente și cum să le diagnosticați

Eroarea ModuleNotFoundError: No module named mistralai înseamnă aproape întotdeauna că terminalul nu utilizează mediul virtual corect. Verificați acest lucru cu which python, care ar trebui să indice către venv-ul dvs., și apoi cu pip list | grep mistralai.

Eroarea ImportError: cannot import name 'Mistral' from 'mistralai' indică un cod scris pentru versiunea 1 a SDK-ului. Începând cu versiunea 2.0, toate importurile se fac prin mistralai.client: scrieți from mistralai.client import Mistral. Lecția despre versiunile SDK detaliază alte modificări.

O eroare SSL sau de rețea dezvăluie adesea un proxy corporativ situat între dvs. și lumea exterioară. Indicați-i explicit lui pip acest lucru:

pip install mistralai --proxy http://proxy.entreprise.com:8080

În final, dacă instalarea respinge versiunea dvs. de Python, rețineți că SDK-ul necesită minim Python 3.10 începând cu versiunea 2.0. Actualizați Python sau instalați pyenv pentru a rula mai multe versiuni în paralel fără a atinge interpretorul de sistem.

Puncte cheie

  • Instalați SDK-ul cu pip install mistralai într-un mediu virtual
  • Versiunea curentă este 3.7.0 (1 noiembrie 2026); importați clientul prin from mistralai.client import Mistral
  • Verificați instalarea listând modelele disponibile
  • Înghețați dependențele în requirements.txt pentru reproductibilitate
  • Este necesar Python 3.10 sau o versiune superioară