Instaliraj Mistral Python SDK
Na ovoj stranici
Preduvjeti
Ažurirano 2. studenoga 2026. — Mistral SDK 3. Ova lekcija prethodno je pokrivala verziju SDK-a 2 i Python 3.9. Trenutna verzija je 3.7.0 (objavljena 1. studenoga 2026.); zahtijeva Python 3.10 ili noviji, a klijent se uvozi putem
from mistralai.client import Mistralod verzije 2.0 (ožujak 2026.). Izvori: mistralai na PyPI-ju · bilješke o izdanju v2.0.0 · bilješke o izdanju v3.0.0.
Instalacija SDK-a zahtijeva tri stvari: Python 3.10 ili noviji, što možeš provjeriti s python --version; ažurirani pip, koji dobiješ putem pip install --upgrade pip; i tvoj Mistral API ključ već postavljen kao varijabla okruženja, kako je objašnjeno u prethodnoj lekciji. Ako Python još nije instaliran na tvojem računalu, preuzmi najnoviju stabilnu verziju s python.org ili upotrijebi upravitelj paketa svog sustava.
Izoliraj svoj projekt prije instalacije bilo čega
Uvijek radi unutar virtualnog okruženja. Ova navika štedi te od česte glavobolje: dva projekta na istom računalu, od kojih jedan zahtijeva specifičnu verziju SDK-a, a drugi drugačiju, gdje jedan jedini pip install tiho slomi prvi projekt ažuriranjem drugog. Virtualno okruženje svakom projektu daje vlastite izolirane ovisnosti, odvojene od paketa na razini cijelog sustava.
# Stvori virtualno okruženje
python -m venv mistral-env
# Aktiviraj na Linuxu / macOSu
source mistral-env/bin/activate
# Aktiviraj na Windowsima
mistral-env\Scripts\activate
Kada se aktivira, tvoja promptska linija terminala bit će prefiksirana imenom okruženja u zagradama: (mistral-env). Ova mala oznaka jamči da se naredbe koje slijede primjenjuju na ispravnu lokaciju—ako se ne pojavi, nemoj ništa instalirati.
Instaliraj službeni SDK
Instalacija Mistral SDK-a zahtijeva samo jednu naredbu:
pip install mistralai
Ovo instalira najnoviju verziju SDK-a: 3.7.0 zaključno s 1. studenim 2026. Generacija 3 započela je s verzijom 3.0, objavljenom 28. rujna 2026. Da bi potvrdio/la da je sve na mjestu, pokreni pip show mistralai kako bi prikazao/la naziv paketa, verziju i ovisnosti.
Ponekad projekt zahtijeva specifičnu verziju, na primjer, kako bi se cijeli tim uskladio tijekom migracije. Ograničenja možeš odrediti na dvije razine:
# Ostani unutar generacije 3
pip install "mistralai>=3,<4"
# Instaliraj točnu verziju
pip install "mistralai==3.7.0"
Usput, pip povlači nekoliko ovisnosti koje se pojavljuju na popisu. Korisno ih je prepoznati, posebno httpx2, HTTP klijent koji rukuje mrežnim pozivima (SDK ovo koristi umjesto httpx počevši od verzije 3.0), i pydantic, koji validira i serijalizira razmijenjene podatke. Nećeš izravno komunicirati s njima, ali njihova prisutnost objašnjava zašto instalacija koja se čini malom ipak zauzima nekoliko megabajta.
Provjeri instalaciju stvarnim API pozivom
Pokretanje pip show dokazuje da paket postoji, ali ne i da tvoja konfiguracija radi. Pravi test upućuje upit API-ju. Stvori datoteku pod nazivom 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!")
# Popis dostupnih modela
models = client.models.list()
print(f"Available models: {len(models.data)}")
for model in models.data[:5]:
print(f" - {model.id}")
Zatim je pokreni:
python test_mistral.py
Ova skripta provjerava dvije stvari odjednom. Provjera api_key odmah razlikuje nedostajuću varijablu okruženja od stvarnog mrežnog problema—bez nje, mogao/la bi potrošiti deset minuta sumnjajući u svoj vatrozid, dok je terminal jednostavno ponovno otvoren bez varijable. Ako se popis modela prikaže, SDK je ispravno instaliran i tvoj ključ prihvaća API.
Učini okruženje reproducibilnim
Kod timskog projekta, instalacija mora biti reproducibilna. Zamrzni svoje ovisnosti:
pip freeze > requirements.txt
Tvoje kolege tada mogu rekonstruirati potpuno isto okruženje jednom naredbom:
pip install -r requirements.txt
Tvoj poslužitelj za implementaciju također će čitati ovu datoteku. Uvedi si naviku ponovnog generiranja svaki put kada dodaš knjižnicu; u suprotnom, kod će raditi na tvojem računalu, a nigdje drugdje.
Četiri česta kvara i kako ih dijagnosticirati
Greška ModuleNotFoundError: No module named mistralai gotovo uvijek znači da terminal ne koristi ispravno virtualno okruženje. Provjeri to s which python, što bi trebalo pokazivati na tvoj venv, a zatim s pip list | grep mistralai.
Greška ImportError: cannot import name 'Mistral' from 'mistralai' ukazuje na kod napisan za SDK verziju 1. Od verzije 2.0, svi se uvozi vrše kroz mistralai.client: napiši from mistralai.client import Mistral. Lekcija o verzijama SDK-a detaljno opisuje druge promjene.
SSL ili mrežna greška često otkriva korporativni proxy smješten između tebe i vanjskog svijeta. Eksplicitno obavijesti pip o tome:
pip install mistralai --proxy http://proxy.entreprise.com:8080
Konačno, ako instalacija odbije tvoju verziju Pythona, zapamti da SDK zahtijeva Python 3.10 kao minimum od verzije 2.0. Ažuriraj Python ili instaliraj pyenv kako bi pokretao/la više verzija usporedno bez diranja sistemskog interpretera.
Ključne točke
- Instaliraj SDK s
pip install mistralaiunutar virtualnog okruženja - Trenutna verzija je 3.7.0 (1. studenoga 2026.); uvezi klijenta putem
from mistralai.client import Mistral - Provjeri instalaciju popisivanjem dostupnih modela
- Zamrzni ovisnosti u
requirements.txtradi reproducibilnosti - Potreban je Python 3.10 ili noviji