Inštalácia Python SDK pre Mistral
Na tejto strane
Predpoklady
Aktualizované 2. novembra 2026 — Mistral SDK 3. Táto lekcia predtým pokrývala verziu SDK 2 a Python 3.9. Aktuálna verzia je 3.7.0 (vydaná 1. novembra 2026); vyžaduje Python 3.10 alebo vyšší a klient sa importuje cez
from mistralai.client import Mistralod verzie 2.0 (marec 2026). Zdroje: mistralai na PyPI · poznámky k vydaniu v2.0.0 · poznámky k vydaniu v3.0.0.
Inštalácia SDK si vyžaduje tri veci: Python 3.10 alebo vyšší, čo overíš príkazom python --version; aktuálny pip, ktorý získaš cez pip install --upgrade pip; a tvoj API kľúč Mistral už nastavený ako premenná prostredia, ako bolo pokryté v predchádzajúcej lekcii. Ak ešte nemáš na stroji nainštalovaný Python, stiahni si najnovšiu stabilnú verziu z python.org alebo použi správcu balíkov svojho systému.
Pred inštaláciou čohokoľvek si izoluj projekt
Vždy pracuj vo vnútri virtuálneho prostredia. Tento zvyk ťa ušetrí od bežného problému: dva projekty na tom istom stroji, kde jeden vyžaduje konkrétnu verziu SDK a druhý inú, pričom jediný príkaz pip install ticho rozbije prvý projekt aktualizáciou druhého. Virtuálne prostredie poskytuje každému projektu vlastné izolované závislosti, oddelené od balíkov celého systému.
# Vytvorenie virtuálneho prostredia
python -m venv mistral-env
# Aktivácia na Linux / macOS
source mistral-env/bin/activate
# Aktivácia na Windows
mistral-env\Scripts\activate
Po aktivácii bude výzva v termináli prefixed názvom prostredia v zátvorkách: (mistral-env). Tento malý marker garantuje, že následné príkazy sa aplikujú na správne miesto – ak sa nezobrazí, nič neinštaluj.
Inštalácia oficiálneho SDK
Inštalácia Mistral SDK zaberie jediný príkaz:
pip install mistralai
Tým sa nainštaluje najnovšia verzia SDK: 3.7.0 k 1. novembru 2026. Generácia 3 začala verziou 3.0, vydanou 28. septembra 2026. Aby si si overil, že je všetko na mieste, spusti pip show mistralai, čo zobrazí názov balíka, verziu a závislosti.
Niekedy projekt vyžaduje konkrétnu verziu, napríklad aby zostal celý tím zosúladený počas migrácie. Obmedzenia môžeš špecifikovať na dvoch úrovniach:
# Zostať v rámci generácie 3
pip install "mistralai>=3,<4"
# Inštalovať presnú verziu
pip install "mistralai==3.7.0"
Počas toho pip stiahne niekoľko závislostí, ktoré sa objavia v zozname. Pomáha ich rozpoznať, najmä httpx2, HTTP klient spravujúci sieťové volania (SDK ho používa namiesto httpx od verzie 3.0), a pydantic, ktorý validuje a serializuje vymieňané dáta. Priamo s nimi interagovať nebudeš, ale ich prítomnosť vysvetľuje, prečo inštalácia, ktorá sa zdá byť malá, stále zaberá niekoľko megabajtov.
Overenie inštalácie reálnym volaním API
Spustenie pip show dokazuje existenciu balíka, nie to, že tvoja konfigurácia funguje. Skutočný test queried API. Vytvor súbor s názvom 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!")
# Zoznam dostupných modelov
models = client.models.list()
print(f"Available models: {len(models.data)}")
for model in models.data[:5]:
print(f" - {model.id}")
Potom ho spusti:
python test_mistral.py
Tento skript kontroluje dve veci naraz. Kontrola api_key okamžite odlíši chýbajúcu premennú prostredia od skutočného sieťového problému – bez nej by si mohol stráviť desať minút podozrením svojho firewallu, keď sa terminál jednoducho otvoril bez premennej. Ak sa zoznam modelov zobrazí, SDK je nainštalované správne a tvoj kľúč je API akceptovaný.
Urob prostredie reprodukovateľným
Pri tímovom projekte musí byť inštalácia reprodukovateľná. Zmraz svoje závislosti:
pip freeze > requirements.txt
Tvoji kolegovia potom môžu zrekonštruovať presne rovnaké prostredie jediným príkazom:
pip install -r requirements.txt
Tento súbor bude čítať aj tvoj nasadzovací server. Zvykni si regenerovať ho zakaždým, keď pridáš knižnicu; inak bude kód fungovať na tvojom stroji a nikde inde.
Štyri bežné zlyhania a ako ich diagnostikovať
Chyba ModuleNotFoundError: No module named mistralai takmer vždy znamená, že terminál nepoužíva správne virtuálne prostredie. Over si to príkazom which python, ktorý by mal ukazovať na tvoj venv, a potom pomocou pip list | grep mistralai.
Chyba ImportError: cannot import name 'Mistral' from 'mistralai' indikuje kód napísaný pre verziu SDK 1. Od verzie 2.0 všetky importy prechádzajú cez mistralai.client: napíš from mistralai.client import Mistral. Lekcia o verziách SDK detailne popisuje ďalšie zmeny.
Chyba SSL alebo siete často odhaľuje firemný proxy server sediaci medzi tebou a vonkajším svetom. Explicitne povedz pipu o ňom:
pip install mistralai --proxy http://proxy.entreprise.com:8080
Nakoniec, ak inštalácia odmietne tvoju verziu Pythonu, pamätaj, že SDK vyžaduje minimálne Python 3.10 od verzie 2.0. Aktualizuj Python, alebo nainštaluj pyenv, aby si mohol spúšťať viacero verzií vedľa seba bez dotyku so systémovým interpretrom.
Kľúčové poznatky
- Nainštaluj SDK príkazom
pip install mistralaivo vnútri virtuálneho prostredia - Aktuálna verzia je 3.7.0 (1. november 2026); importuj klienta cez
from mistralai.client import Mistral - Over inštaláciu výpisom dostupných modelov
- Zmraz závislosti v
requirements.txtpre reprodukovateľnosť - Vyžaduje sa Python 3.10 alebo vyšší