Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Installera Mistral Python SDK

Lektion 4 av 14 Uppdaterad 2 november 2026 Utvecklare
På denna sida
  1. Förutsättningar
  2. Isolera ditt projekt innan du installerar något
  3. Installera den officiella SDK:n
  4. Verifiera installationen med ett riktigt API-anrop
  5. Gör miljön reproducerbar
  6. Fyra vanliga fel och hur du diagnostiserar dem
  7. Viktiga punkter

Förutsättningar

Uppdaterat 2 november 2026 — Mistral SDK 3. Denna lektion täckte tidigare SDK-version 2 och Python 3.9. Den aktuella versionen är 3.7.0 (släppt 1 november 2026); den kräver Python 3.10 eller högre, och klienten importeras via from mistralai.client import Mistral från och med version 2.0 (mars 2026). Källor: mistralai på PyPI · v2.0.0 release notes · v3.0.0 release notes.

Installation av SDK:n kräver tre saker: Python 3.10 eller högre, vilket du verifierar med python --version; en uppdaterad pip, installerad via pip install --upgrade pip; och din Mistral API-nyckel redan inställd som en miljövariabel, enligt föregående lektion. Om Python inte är installerat på din maskin än, hämta senaste stabila version från python.org eller använd ditt systems pakethanterare.

Isolera ditt projekt innan du installerar något

Arbeta alltid inuti en virtuell miljö. Denna vana sparar dig från ett vanligt huvudbry: två projekt på samma maskin där det ena kräver en specifik SDK-version och det andra en annan, där ett enda pip install tyst bryter det första projektet genom att uppdatera det andra. En virtuell miljö ger varje projekt sina egna isolerade beroenden, separerade från dina systemomfattande paket.

# Skapa den virtuella miljön
python -m venv mistral-env

# Aktivera på Linux / macOS
source mistral-env/bin/activate

# Aktivera på Windows
mistral-env\Scripts\activate

När den är aktiverad kommer din terminalprompt att ha prefixet miljönamnet inom parentes: (mistral-env). Denna lilla markör garanterar att efterföljande kommandon appliceras på rätt plats – om den inte dyker upp, installera ingenting.

Installera den officiella SDK:n

Installation av Mistral SDK:n tar ett enda kommando:

pip install mistralai

Detta installerar den senaste SDK-versionen: 3.7.0 per den 1 november 2026. Generation 3 började med version 3.0, släppt den 28 september 2026. För att bekräfta att allt är på plats, kör pip show mistralai för att visa paketnamn, version och beroenden.

Ibland kräver ett projekt en specifik version, till exempel för att hålla ett helt team synkroniserat under en migrering. Du kan ange begränsningar på två nivåer:

# Stanna inom generation 3
pip install "mistralai>=3,<4"

# Installera en exakt version
pip install "mistralai==3.7.0"

På vägen hämtar pip in några beroenden som dyker upp i listan. Det hjälper att känna igen dem, särskilt httpx2, HTTP-klienten som hanterar nätverksanrop (SDK:n använder denna istället för httpx från och med version 3.0), och pydantic, som validerar och serialiserar utbytt data. Du kommer inte att interagera med dessa direkt, men deras närvaro förklarar varför en installation som verkar liten ändå upptar några megabyte.

Verifiera installationen med ett riktigt API-anrop

Att köra pip show bevisar att paketet finns, inte att din konfiguration fungerar. Det verkliga testet frågar API:et. Skapa en fil som heter 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!")

    # List available models
    models = client.models.list()
    print(f"Available models: {len(models.data)}")
    for model in models.data[:5]:
        print(f"  - {model.id}")

Kör den sedan:

python test_mistral.py

Detta skript kontrollerar två saker samtidigt. Kontrollen av api_key skiljer omedelbart en saknad miljövariabel från ett äkta nätverksproblem – utan den kan du spendera tio minuter på att misstänka din brandvägg när terminalen helt enkelt öppnades på nytt utan variabeln. Om modellistan visas är SDK:n korrekt installerad och din nyckel accepteras av API:et.

Gör miljön reproducerbar

I ett teamprojekt måste installationen vara reproducerbar. Frys dina beroenden:

pip freeze > requirements.txt

Dina kollegor kan sedan återskapa exakt samma miljö med ett enda kommando:

pip install -r requirements.txt

Din distributionsserver kommer också att läsa denna fil. Vänj dig vid att regenerera den varje gång du lägger till ett bibliotek; annars kommer koden att fungera på din maskin och ingen annanstans.

Fyra vanliga fel och hur du diagnostiserar dem

Felet ModuleNotFoundError: No module named mistralai betyder nästan alltid att terminalen inte använder rätt virtuell miljö. Verifiera detta med which python, vilket ska peka på din venv, och sedan med pip list | grep mistralai.

Felet ImportError: cannot import name 'Mistral' from 'mistralai' indikerar kod skriven för SDK-version 1. Sedan version 2.0 går alla importer via mistralai.client: skriv from mistralai.client import Mistral. Lektionen om SDK-versioner detaljerar andra ändringar.

Ett SSL- eller nätverksfel avslöjar ofta en företagsproxy som sitter mellan dig och omvärlden. Berätta explicit för pip om den:

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

Slutligen, om installationen avvisar din Python-version, kom ihåg att SDK:n har krävt Python 3.10 som minimum sedan version 2.0. Uppdatera Python, eller installera pyenv för att köra flera versioner sida vid sida utan att röra systemtolken.

Viktiga punkter

  • Installera SDK:n med pip install mistralai inuti en virtuell miljö
  • Den aktuella versionen är 3.7.0 (1 november 2026); importera klienten via from mistralai.client import Mistral
  • Verifiera installationen genom att lista tillgängliga modeller
  • Frys beroenden i requirements.txt för reproducerbarhet
  • Python 3.10 eller högre krävs