Instalace Python SDK pro Mistral
Na této stránce
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 Mistralod 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 mistralaiuvnitř 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šší