Instalē Mistral Python SDK
Šajā lapā
Priekšnosacījumi
Atjaunināts 2026. gada 2. novembrī — Mistral SDK 3. Šī nodarbība iepriekš aptvēra SDK 2. versiju un Python 3.9. Pašreizējā versija ir 3.7.0 (izlaista 2026. gada 1. novembrī); tai ir nepieciešams Python 3.10 vai jaunāks, un klients tiek importēts caur
from mistralai.client import Mistral, sākot ar 2.0 versiju (2026. gada marts). Avoti: mistralai vietnē PyPI · v2.0.0 laidiena piezīmes · v3.0.0 laidiena piezīmes.
SDK instalēšanai nepieciešamas trīs lietas: Python 3.10 vai jaunāks, ko vari pārbaudīt ar python --version; atjaunināts pip, ko iegūsti ar pip install --upgrade pip; un tava Mistral API atslēga, kas jau iestatīta kā vides mainīgais, kā apskatīts iepriekšējā nodarbībā. Ja Python vēl nav instalēts tavā ierīcē, lejupielādē jaunāko stabilo laidieni no python.org vai izmanto savas sistēmas pakotņu pārvaldnieku.
Izolē savu projektu pirms jebkādas instalācijas
Vienmēr strādā virtuālajā vidē. Šis ieradums pasargā tevi no biežas galvassāpes: divi projekti vienā ierīcē, kur vienam nepieciešama konkrēta SDK versija, bet otram — cita, un viens vienīgs pip install klusi sabojā pirmo projektu, atjauninot otro. Virtuālā vide katram projektam nodrošina savas izolētas atkarības, atdalītas no sistēmas līmeņa pakotnēm.
# Izveido virtuālo vidi
python -m venv mistral-env
# Aktivizē Linux / macOS
source mistral-env/bin/activate
# Aktivizē Windows
mistral-env\Scripts\activate
Kad vide ir aktivizēta, tava termināļa uzvedne tiks papildināta ar vides nosaukumu iekavās: (mistral-env). Šis mazais marķieris garantē, ka turpmākās komandas attiecas uz pareizo atrašanās vietu — ja tas neparādās, neko neinstalē.
Instalē oficiālo SDK
Mistral SDK instalēšanai pietiek ar vienu komandu:
pip install mistralai
Tas instalē jaunāko SDK versiju: 3.7.0 (2026. gada 1. novembra stāvoklī). Trešā paaudze sākās ar 3.0 versiju, kas izlaista 2026. gada 28. septembrī. Lai pārliecinātos, ka viss ir kārtībā, palaid pip show mistralai, lai parādītu pakotnes nosaukumu, versiju un atkarības.
Dažreiz projektam ir nepieciešama konkrēta versija, piemēram, lai migrācijas laikā visai komandai būtu vienota vide. Ierobežojumus vari norādīt divos līmeņos:
# Paliec 3. paaudzes ietvaros
pip install "mistralai>=3,<4"
# Instalē precīzu versiju
pip install "mistralai==3.7.0"
Procesa laikā pip lejupielādē dažas atkarības, kas parādās sarakstā. Ir lietderīgi tās pazīt, jo īpaši httpx2 — HTTP klientu, kas apstrādā tīkla izsaukumus (SDK to izmanto httpx vietā, sākot ar 3.0 versiju), un pydantic, kas validē un serializē apmainītos datus. Tu ar tām tieši nestrādāsi, taču to klātbūtne izskaidro, kāpēc instalācija, kas šķiet maza, tomēr aizņem dažus megabaitus.
Pārbaudi instalāciju ar reālu API izsaukumu
pip show palaišana pierāda tikai to, ka pakotne eksistē, nevis to, ka tava konfigurācija darbojas. Īstais tests ir API vaicājums. Izveido failu ar nosaukumu 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!")
# Uzskaiti pieejamos modeļus
models = client.models.list()
print(f"Available models: {len(models.data)}")
for model in models.data[:5]:
print(f" - {model.id}")
Tad palaid to:
python test_mistral.py
Šis skripts vienlaikus pārbauda divas lietas. Pārbaude attiecībā uz api_key uzreiz atšķir trūkstošu vides mainīgo no patiesa tīkla problēmas — bez tā tu vari pavadīt desmit minūtes, aizdomājoties par savu ugunsmūri, kamēr terminālis vienkārši tika atvērts no jauna bez šī mainīgā. Ja modeļu saraksts tiek parādīts, SDK ir instalēts pareizi un tava atslēga tiek pieņemta API.
Padari vidi reproducējamu
Strādājot komandas projektā, instalācijai ir jābūt reproducējamai. Fiksē savas atkarības:
pip freeze > requirements.txt
Tavi kolēģi tad varēs atjaunot tieši tādu pašu vidi ar vienu komandu:
pip install -r requirements.txt
Arī tava izvietošanas serveris lasīs šo failu. Pieradini sevi to ģenerēt no jauna katru reizi, kad pievieno bibliotēku; pretējā gadījumā kods darbosies tikai tavā ierīcē un nekur citur.
Četras biežas kļūmes un to diagnosticēšana
Kļūda ModuleNotFoundError: No module named mistralai gandrīz vienmēr nozīmē, ka terminālis neizmanto pareizo virtuālo vidi. Pārbaudi to ar which python, kam vajadzētu norādīt uz tavu venv, un pēc tam ar pip list | grep mistralai.
Kļūda ImportError: cannot import name 'Mistral' from 'mistralai' norāda uz kodu, kas rakstīts SDK 1. versijai. Kopš 2.0 versijas visi importi notiek caur mistralai.client: raksti from mistralai.client import Mistral. Nodarbībā par SDK versijām ir detalizēti aprakstītas citas izmaiņas.
SSL vai tīkla kļūda bieži atklāj korporatīvo starpniekserveri, kas atrodas starp tevi un ārējo pasauli. Eksplicīti norādi to pip:
pip install mistralai --proxy http://proxy.entreprise.com:8080
Visbeidzot, ja instalācija noraida tavu Python versiju, atceries, ka SDK kopš 2.0 versijas prasa vismaz Python 3.10. Atjaunini Python vai instalē pyenv, lai vienlaikus darbinātu vairākas versijas, neaiztiekot sistēmas interpretatoru.
Galvenās atziņas
- Instalē SDK ar
pip install mistralaivirtuālajā vidē - Pašreizējā versija ir 3.7.0 (2026. gada 1. novembris); importē klientu caur
from mistralai.client import Mistral - Pārbaudi instalāciju, uzskaitot pieejamos modeļus
- Fiksē atkarības failā
requirements.txt, lai nodrošinātu reproducējamību - Nepieciešams Python 3.10 vai jaunāks