Mistral Python SDK installieren

Voraussetzungen

Aktualisiert am 2. November 2026 — Mistral SDK 3. Diese Lektion behandelte zuvor SDK-Version 2 und Python 3.9. Die aktuelle Version ist 3.7.0 (veröffentlicht am 1. November 2026); sie erfordert Python 3.10 oder höher, und der Client wird ab Version 2.0 (März 2026) über from mistralai.client import Mistral importiert. Quellen: mistralai auf PyPI · Release-Notizen v2.0.0 · Release-Notizen v3.0.0.

Die Installation des SDK erfordert drei Dinge: Python 3.10 oder höher, das Sie mit python --version überprüfen können; einen aktuellen pip, der über pip install --upgrade pip erhalten wird; und Ihren Mistral API-Schlüssel, der bereits als Umgebungsvariable gesetzt ist, wie in der vorherigen Lektion behandelt. Wenn Python noch nicht auf Ihrem Gerät installiert ist, laden Sie die neueste stabile Version von python.org herunter oder nutzen Sie den Paketmanager Ihres Systems.

Isolieren Sie Ihr Projekt, bevor Sie etwas installieren

Arbeiten Sie immer innerhalb einer virtuellen Umgebung. Diese Gewohnheit spart Ihnen einen häufigen Kopfschmerz: zwei Projekte auf derselben Maschine, von denen eines eine bestimmte SDK-Version benötigt und das andere eine andere, wobei ein einzelner pip install-Befehl das erste Projekt stumm durch das Aktualisieren des zweiten zerstört. Eine virtuelle Umgebung gibt jedem Projekt seine eigenen isolierten Abhängigkeiten, getrennt von Ihren systemweiten Paketen.

# Virtuelle Umgebung erstellen
python -m venv mistral-env

# Aktivieren unter Linux/macOS
source mistral-env/bin/activate

# Aktivieren unter Windows
mistral-env\Scripts\activate

Sobald aktiviert, wird Ihr Terminal-Prompt mit dem Umgebungsnamen in Klammern vorangestellt: (mistral-env). Dieser kleine Marker garantiert, dass nachfolgende Befehle auf den richtigen Ort angewendet werden – wenn er nicht erscheint, installieren Sie nichts.

Offizielles SDK installieren

Die Installation des Mistral SDK erfolgt mit einem einzigen Befehl:

pip install mistralai

Dies installiert die neueste SDK-Version: 3.7.0 zum Zeitpunkt des 1. November 2026. Generation 3 begann mit Version 3.0, veröffentlicht am 28. September 2026. Um zu bestätigen, dass alles in Ordnung ist, führen Sie pip show mistralai aus, um Paketname, Version und Abhängigkeiten anzuzeigen.

Manchmal benötigt ein Projekt eine bestimmte Version, beispielsweise, um ein ganzes Team während eines Migrationsprozesses synchron zu halten. Sie können Einschränkungen auf zwei Ebenen angeben:

# Innerhalb von Generation 3 bleiben
pip install "mistralai>=3,<4"

# Eine exakte Version installieren
pip install "mistralai==3.7.0"

Dabei zieht pip einige Abhängigkeiten nach, die in der Liste erscheinen. Es hilft, diese zu erkennen, insbesondere httpx2, den HTTP-Client, der Netzwerkanrufe verarbeitet (das SDK verwendet dies ab Version 3.0 anstelle von httpx), und pydantic, das ausgetauschte Daten validiert und serialisiert. Sie werden nicht direkt mit diesen interagieren, aber ihre Anwesenheit erklärt, warum eine Installation, die winzig erscheint, dennoch einige Megabyte belegt.

Installation mit einem echten API-Aufruf verifizieren

Das Ausführen von pip show beweist nur, dass das Paket existiert, nicht dass Ihre Konfiguration funktioniert. Der echte Test fragt die API ab. Erstellen Sie eine Datei namens 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!")

    # Verfügbare Modelle auflisten
    models = client.models.list()
    print(f"Available models: {len(models.data)}")
    for model in models.data[:5]:
        print(f"  - {model.id}")

Führen Sie dann folgenden Befehl aus:

python test_mistral.py

Dieses Skript prüft zwei Dinge gleichzeitig. Die Prüfung von api_key unterscheidet sofort zwischen einer fehlenden Umgebungsvariable und einem echten Netzwerkproblem – ohne sie könnten Sie zehn Minuten damit verbringen, Ihren Firewall zu verdächtigen, während das Terminal einfach nur ohne die Variable neu geöffnet wurde. Wenn die Modellliste angezeigt wird, ist das SDK korrekt installiert und Ihr Schlüssel wird von der API akzeptiert.

Umgebung reproduzierbar machen

Bei einem Teamprojekt muss die Installation reproduzierbar sein. Erfrieren Sie Ihre Abhängigkeiten:

pip freeze > requirements.txt

Ihre Kollegen können dann die exakt gleiche Umgebung mit einem einzigen Befehl wiederherstellen:

pip install -r requirements.txt

Ihr Bereitstellungsserver liest diese Datei ebenfalls. Gewöhnen Sie sich an, sie jedes Mal neu zu generieren, wenn Sie eine Bibliothek hinzufügen; sonst wird der Code auf Ihrer Maschine funktionieren und nirgendwo sonst.

Vier häufige Fehler und wie man sie diagnostiziert

Der Fehler ModuleNotFoundError: No module named mistralai bedeutet fast immer, dass das Terminal nicht die richtige virtuelle Umgebung verwendet. Überprüfen Sie dies mit which python, das auf Ihre venv zeigen sollte, und dann mit pip list | grep mistralai.

Der Fehler ImportError: cannot import name 'Mistral' from 'mistralai' deutet auf Code hin, der für SDK-Version 1 geschrieben wurde. Seit Version 2.0 gehen alle Imports über mistralai.client: schreiben Sie from mistralai.client import Mistral. Die Lektion zu SDK-Versionen erläutert weitere Änderungen.

Ein SSL- oder Netzwerkfehler offenbart oft ein Unternehmensproxy, das zwischen Ihnen und der Außenwelt sitzt. Weisen Sie pip dies explizit zu:

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

Schließlich, wenn die Installation Ihre Python-Version ablehnt, denken Sie daran, dass das SDK seit Version 2.0 eine Mindestversion von Python 3.10 erfordert. Aktualisieren Sie Python oder installieren Sie pyenv, um mehrere Versionen nebeneinander auszuführen, ohne den Systeminterpreter zu berühren.

Kernaussagen

• Installieren Sie das SDK mit pip install mistralai innerhalb einer virtuellen Umgebung
• Die aktuelle Version ist 3.7.0 (1. November 2026); importieren Sie den Client über from mistralai.client import Mistral
• Verifizieren Sie die Installation, indem Sie verfügbare Modelle auflisten
• Erfrieren Sie Abhängigkeiten in requirements.txt für Reproduzierbarkeit
• Python 3.10 oder höher ist erforderlich