Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Instaliraj Mistral Python SDK

Lekcija 4 od 14 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Preduvjeti
  2. Izoliraj svoj projekt prije instalacije bilo čega
  3. Instaliraj službeni SDK
  4. Provjeri instalaciju stvarnim API pozivom
  5. Učini okruženje reproducibilnim
  6. Četiri česta kvara i kako ih dijagnosticirati
  7. Ključne točke

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 Mistral od 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 mistralai unutar 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.txt radi reproducibilnosti
  • Potreban je Python 3.10 ili noviji