Asenna Mistral Python SDK
Tällä sivulla
Edellytykset
Päivitetty 2. marraskuuta 2026 — Mistral SDK 3. Tämä oppitunti käsitteli aiemmin SDK:n versiota 2 ja Pythonia 3.9. Nykyinen versio on 3.7.0 (julkaistu 1. marraskuuta 2026); se vaatii Python 3.10:n tai uudemman, ja asiakasohjelmisto tuodaan muodossa
from mistralai.client import Mistralversiosta 2.0 (maaliskuu 2026) alkaen. Lähteet: mistralai PyPI:ssä · v2.0.0 julkaisutiedot · v3.0.0 julkaisutiedot.
SDK:n asentaminen vaatii kolme asiaa: Python 3.10 tai uudempi, jonka voit tarkistaa komennolla python --version; ajantasainen pip, jonka saat komennolla pip install --upgrade pip; ja Mistral API -avaimesi, joka on jo asetettu ympäristömuuttujaksi edellisessä oppitunnissa käsitellyllä tavalla. Jos Pythonia ei ole vielä asennettu koneellesi, lataa uusin vakaa versio osoitteesta python.org tai käytä järjestelmäsi pakettienhallintaa.
Eristä projektisi ennen kuin asennat mitään
Työskentele aina virtuaaliympäristössä. Tämä tapa säästää sinut yleiseltä harmilta: kaksi projektia samalla koneella, joista toinen vaatii tietyn SDK-version ja toinen eri version, jolloin yksittäinen pip install rikkoo hiljaa ensimmäisen projektin päivittämällä toisen. Virtuaaliympäristö antaa jokaiselle projektille omat eristetyt riippuvuudet erillään järjestelmän laajuisista paketeista.
# Luo virtuaaliympäristö
python -m venv mistral-env
# Aktivoi Linuxissa / macOS:ssä
source mistral-env/bin/activate
# Aktivoi Windowsissa
mistral-env\Scripts\activate
Kun ympäristö on aktivoitu, päätteesi kehote saa etuliitteeksi ympäristön nimen sulkeissa: (mistral-env). Tämä pieni merkki takaa, että seuraavat komennot kohdistuvat oikeaan sijaintiin – jos sitä ei ilmesty, älä asenna mitään.
Asenna virallinen SDK
Mistral SDK:n asentaminen vaatii vain yhden komennon:
pip install mistralai
Tämä asentaa SDK:n uusimman version: 3.7.0 (tilanne 1. marraskuuta 2026). Sukupolvi 3 alkoi versiosta 3.0, joka julkaistiin 28. syyskuuta 2026. Varmistaaksesi, että kaikki on kunnossa, suorita pip show mistralai nähdäksesi paketin nimen, version ja riippuvuudet.
Joskus projekti vaatii tietyn version, esimerkiksi pitääkseen koko tiimin linjassa migraation aikana. Voit määrittää rajoitteet kahdella tasolla:
# Pysy sukupolvessa 3
pip install "mistralai>=3,<4"
# Asenna tarkka versio
pip install "mistralai==3.7.0"
Asennuksen aikana pip lataa muutamia riippuvuuksia, jotka ilmestyvät listaan. Niiden tunnistaminen on hyödyllistä, erityisesti httpx2, joka on verkkopyyntöjä hoitava HTTP-asiakas (SDK käyttää tätä httpx:n sijaan versiosta 3.0 alkaen), sekä pydantic, joka validoi ja sarjoittaa vaihdettavat tiedot. Et ole tekemisissä näiden kanssa suoraan, mutta niiden olemassaolo selittää, miksi pieneltä näyttävä asennus vie silti muutaman megatavun tilaa.
Varmista asennus aidolla API-kutsulla
Komennon pip show suorittaminen todistaa vain paketin olemassaolon, ei sitä, että konfiguraatiosi toimii. Todellinen testi kysyy API:lta tietoja. Luo tiedosto nimeltä 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!")
# Listaa käytettävissä olevat mallit
models = client.models.list()
print(f"Available models: {len(models.data)}")
for model in models.data[:5]:
print(f" - {model.id}")
Suorita se sitten:
python test_mistral.py
Tämä skripti tarkistaa kaksi asiaa kerralla. Tarkistus muuttujalle api_key erottaa heti puuttuvan ympäristömuuttujan aidosta verkkovirheestä – ilman sitä saatat käyttää kymmenen minuuttia epäillen palomuuriasi, kun taas pääte oli vain avattu uudelleen ilman muuttujaa. Jos mallilista ilmestyy näkyviin, SDK on asennettu oikein ja avaimesi kelpaa API:lle.
Tee ympäristöstä toistettava
Tiimiprojektissa asennuksen on oltava toistettava. Lukitse riippuvuutesi:
pip freeze > requirements.txt
Kollegasi voivat tämän jälkeen rakentaa täsmälleen saman ympäristön yhdellä komennolla:
pip install -r requirements.txt
Myös käyttöönottopalvelimesi lukee tämän tiedoston. Opettele uudelleengeneroimaan se aina kun lisäät kirjaston; muuten koodi toimii koneellasi eikä missään muualla.
Neljä yleistä virhettä ja niiden diagnosointi
Virhe ModuleNotFoundError: No module named mistralai tarkoittaa lähes aina sitä, ettei pääte käytä oikeaa virtuaaliympäristöä. Varmista tämä komennolla which python, jonka pitäisi osoittaa venv:iisi, ja sen jälkeen komennolla pip list | grep mistralai.
Virhe ImportError: cannot import name 'Mistral' from 'mistralai' viittaa koodiin, joka on kirjoitettu SDK:n versiolle 1. Versiosta 2.0 alkaen kaikki tuonnit tehdään kautta mistralai.client: kirjoita from mistralai.client import Mistral. Oppitunti SDK-versioista kertoo muista muutoksista.
SSL- tai verkkovirhe paljastaa usein yrityksen välityspalvelimen (proxy) sinun ja ulkomaailman välissä. Kerro pipille siitä eksplisiittisesti:
pip install mistralai --proxy http://proxy.entreprise.com:8080
Lopuksi, jos asennus hylkää Python-versiosi, muista, että SDK on vaatinut vähintään Python 3.10:ttä versiosta 2.0 alkaen. Päivitä Python tai asenna pyenv ajamaan useita versioita rinnakkain koskematta järjestelmän tulkkiin.
Keskeiset asiat
- Asenna SDK komennolla
pip install mistralaivirtuaaliympäristön sisällä - Nykyinen versio on 3.7.0 (1. marraskuuta 2026); tuo asiakasohjelmisto komennolla
from mistralai.client import Mistral - Varmista asennus listaamalla käytettävissä olevat mallit
- Lukitse riippuvuudet tiedostoon
requirements.txttoistettavuuden vuoksi - Python 3.10 tai uudempi on vaadittu