Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Instalace Python SDK pro Mistral

Lekce 4 z 14 Aktualizováno 2. listopadu 2026 Vývojář
Na této stránce
  1. Předpoklady
  2. Před instalací čehokoli si projekt izoluj
  3. Instalace oficiálního SDK
  4. Ověření instalace skutečným voláním API
  5. Zajisti reprodukovatelnost prostředí
  6. Čtyři běžné chyby a jak je diagnostikovat
  7. Klíčové poznatky

Předpoklady

Aktualizováno 2. listopadu 2026 — Mistral SDK 3. Tato lekce dříve pokrývala verzi SDK 2 a Python 3.9. Aktuální verze je 3.7.0 (vydána 1. listopadu 2026); vyžaduje Python 3.10 nebo vyšší a klient se importuje pomocí from mistralai.client import Mistral od verze 2.0 (březen 2026). Zdroje: mistralai na PyPI · poznámky k vydání v2.0.0 · poznámky k vydání v3.0.0.

Instalace SDK vyžaduje tři věci: Python 3.10 nebo vyšší, což ověříš příkazem python --version; aktuální pip, který získáš přes pip install --upgrade pip; a tvůj klíč Mistral API již nastavený jako proměnná prostředí, jak bylo popsáno v předchozí lekci. Pokud ještě nemáš na stroji nainstalovaný Python, stáhni si nejnovější stabilní verzi z python.org nebo použij správce balíčků svého systému.

Před instalací čehokoli si projekt izoluj

Vždy pracuj uvnitř virtuálního prostředí. Tento zvyk tě ušetří běžného trápení: dva projekty na stejném stroji, kde jeden vyžaduje konkrétní verzi SDK a druhý jinou, přičemž jediný příkaz pip install tiše rozbije první projekt aktualizací toho druhého. Virtuální prostředí poskytuje každému projektu vlastní izolované závislosti oddělené od systémových balíčků.

# Vytvoření virtuálního prostředí
python -m venv mistral-env

# Aktivace na Linux / macOS
source mistral-env/bin/activate

# Aktivace na Windows
mistral-env\Scripts\activate

Po aktivaci bude tvůj příkazový řádek prefixed názvem prostředí v závorkách: (mistral-env). Tento malý marker zaručuje, že následující příkazy cílí na správné umístění – pokud se nezobrazí, nic neinstaluj.

Instalace oficiálního SDK

Instalace Mistral SDK zabere jediný příkaz:

pip install mistralai

Tím se nainstaluje nejnovější verze SDK: 3.7.0 k datu 1. listopadu 2026. Generace 3 začala verzí 3.0 vydanou 28. září 2026. Pro potvrzení, že je vše v pořádku, spusť pip show mistralai, který zobrazí název balíčku, verzi a závislosti.

Někdy projekt vyžaduje konkrétní verzi, například aby zůstal celý tým během migrace synchronizovaný. Omezení můžeš specifikovat na dvou úrovních:

# Zůstat v rámci generace 3
pip install "mistralai>=3,<4"

# Instalace přesné verze
pip install "mistralai==3.7.0"

Při tom pip stáhne několik závislostí, které se objeví v seznamu. Je užitečné je znát, zejména httpx2, HTTP klient zpracovávající síťové volání (SDK používá tento místo httpx od verze 3.0), a pydantic, který validuje a serializuje vyměňovaná data. S těmito přímo pracovat nebudeš, ale jejich přítomnost vysvětluje, proč instalace, která se zdá malá, přesto zabírá několik megabajtů.

Ověření instalace skutečným voláním API

Spuštění pip show dokazuje pouze existenci balíčku, nikoli funkčnost tvé konfigurace. Skutečným testem je dotaz na API. Vytvoř soubor s názvem 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!")

    # Výpis dostupných modelů
    models = client.models.list()
    print(f"Available models: {len(models.data)}")
    for model in models.data[:5]:
        print(f"  - {model.id}")

Poté jej spusť:

python test_mistral.py

Tento skript kontroluje dvě věci najednou. Kontrola api_key okamžitě rozliší chybějící proměnnou prostředí od skutečného problému se sítí – bez ní bys mohl strávit deset minut podezíráním firewallu, zatímco terminál byl jednoduše znovu otevřen bez této proměnné. Pokud se zobrazí seznam modelů, je SDK nainstalováno správně a tvůj klíč je API akceptován.

Zajisti reprodukovatelnost prostředí

U týmového projektu musí být instalace reprodukovatelná. Zmraz své závislosti:

pip freeze > requirements.txt

Tvoji kolegové pak mohou rekonstruovat přesně stejné prostředí jediným příkazem:

pip install -r requirements.txt

Tento soubor bude číst také tvůj nasazovací server. Zvykni si jej regenerovat pokaždé, když přidáš knihovnu; jinak bude kód fungovat na tvém stroji a nikde jinde.

Čtyři běžné chyby a jak je diagnostikovat

Chyba ModuleNotFoundError: No module named mistralai téměř vždy znamená, že terminál nepoužívá správné virtuální prostředí. Ověř to pomocí which python, který by měl ukazovat na tvůj venv, a poté pomocí pip list | grep mistralai.

Chyba ImportError: cannot import name 'Mistral' from 'mistralai' indikuje kód napsaný pro verzi SDK 1. Od verze 2.0 všechny importy procházejí přes mistralai.client: piš from mistralai.client import Mistral. Lekce o verzích SDK podrobně popisuje další změny.

Chyba SSL nebo sítě často odhaluje firemní proxy sedící mezi tebou a vnějším světem. Explicitně o ní informuj pip:

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

Nakonec, pokud instalace odmítne tvou verzi Pythonu, pamatuj, že SDK vyžaduje jako minimum Python 3.10 od verze 2.0. Aktualizuj Python, nebo nainstaluj pyenv pro spuštění více verzí vedle sebe bez zásahu do systémového interpretu.

Klíčové poznatky

  • Nainstaluj SDK pomocí pip install mistralai uvnitř virtuálního prostředí
  • Aktuální verze je 3.7.0 (1. listopad 2026); klienta importuj přes from mistralai.client import Mistral
  • Ověř instalaci výpisem dostupných modelů
  • Pro reprodukovatelnost zmraz závislosti v requirements.txt
  • Je vyžadován Python 3.10 nebo vyšší