Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Inštalácia Python SDK pre Mistral

Lekcia 4 z 14 Aktualizované 2. novembra 2026 Vývojár
Na tejto strane
  1. Predpoklady
  2. Pred inštaláciou čohokoľvek si izoluj projekt
  3. Inštalácia oficiálneho SDK
  4. Overenie inštalácie reálnym volaním API
  5. Urob prostredie reprodukovateľným
  6. Štyri bežné zlyhania a ako ich diagnostikovať
  7. Kľúčové poznatky

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 Mistral od 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 mistralai vo 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.txt pre reprodukovateľnosť
  • Vyžaduje sa Python 3.10 alebo vyšší