Installer le SDK Python Mistral

Ce qu’il faut avoir sous la main

Mise à jour du 2 novembre 2026 — SDK Mistral 3. Cette leçon décrivait la version 2 du SDK et Python 3.9. La version actuelle est la 3.7.0 (1er novembre 2026) ; elle exige Python 3.10 ou supérieur, et le client s’importe par from mistralai.client import Mistral depuis la version 2.0 (mars 2026). Sources : mistralai sur PyPI · notes de version 2.0.0 · notes de version 3.0.0.

L’installation du SDK suppose trois choses : Python 3.10 ou supérieur, que vous vérifiez d’un python --version ; un pip à jour, que vous obtenez avec pip install --upgrade pip ; et votre clé API Mistral déjà déclarée en variable d’environnement, comme vu à la leçon précédente. Si Python n’est pas encore installé sur votre machine, prenez la dernière version stable sur python.org ou passez par le gestionnaire de paquets de votre système.

Isoler le projet avant d’installer quoi que ce soit

Travaillez toujours dans un environnement virtuel. C’est le réflexe qui vous épargnera la situation suivante : deux projets sur la même machine, l’un exigeant une version du SDK, l’autre une version différente, et un pip install qui casse silencieusement le premier en mettant à jour le second. L’environnement virtuel donne à chaque projet ses propres dépendances, indépendantes de celles du système.

# Créer l'environnement virtuel
python -m venv mistral-env

# Activer sur Linux / macOS
source mistral-env/bin/activate

# Activer sur Windows
mistral-env\Scripts\activate

Une fois l’environnement activé, votre terminal préfixe son invite du nom entre parenthèses : (mistral-env). Ce petit marqueur est votre garantie que les commandes suivantes s’appliquent bien au bon endroit — s’il n’apparaît pas, n’installez rien.

Installer le SDK officiel

Le SDK Mistral tient dans une seule commande :

pip install mistralai

Vous obtenez ainsi la dernière version du SDK : la 3.7.0 au 1er novembre 2026. La génération 3 a commencé avec la version 3.0, publiée le 28 septembre 2026. Pour confirmer que tout est en place, pip show mistralai affiche le nom du package, sa version et ses dépendances.

Il arrive qu’un projet impose une version précise, par exemple parce qu’une équipe entière doit rester alignée le temps d’une migration. La syntaxe permet les deux niveaux de contrainte :

# Rester sur la génération 3
pip install "mistralai>=3,<4"

# Installer une version exacte
pip install "mistralai==3.7.0"

Au passage, pip tire quelques dépendances que vous verrez apparaître dans la liste et qu’il est utile de reconnaître, en particulier httpx2, le client HTTP qui porte les appels réseau (le SDK l’utilise à la place de httpx depuis la version 3.0), et pydantic, qui valide et sérialise les données échangées. Vous n’aurez rien à en faire directement, mais leur présence explique pourquoi une installation qui semble minuscule occupe quelques mégaoctets.

Vérifier l’installation par un appel réel

Un pip show prouve que le package est présent, pas que votre configuration fonctionne. Le test qui compte interroge l’API. Créez un fichier test_mistral.py :

import os
from mistralai.client import Mistral

api_key = os.environ.get("MISTRAL_API_KEY")

if not api_key:
    print("Erreur : la variable MISTRAL_API_KEY n'est pas définie.")
else:
    client = Mistral(api_key=api_key)
    print("Client Mistral initialisé avec succès !")

    # Lister les modèles disponibles
    models = client.models.list()
    print(f"Modèles disponibles : {len(models.data)}")
    for model in models.data[:5]:
        print(f"  - {model.id}")

Puis exécutez-le :

python test_mistral.py

Ce script vérifie deux choses d’un coup. Le test sur api_key distingue immédiatement une variable d’environnement absente d’un vrai problème réseau — sans lui, vous passeriez dix minutes à soupçonner votre pare-feu alors que le terminal avait simplement été rouvert sans la variable. Et si la liste des modèles s’affiche, c’est que le SDK est correctement installé et que votre clé est acceptée par l’API.

Rendre l’environnement reproductible

Sur un projet à plusieurs, l’installation doit pouvoir être rejouée à l’identique. Figez donc vos dépendances :

pip freeze > requirements.txt

Vos collègues reconstruisent alors le même environnement en une commande :

pip install -r requirements.txt

C’est aussi ce fichier que lira votre serveur de déploiement. Prenez l’habitude de le régénérer chaque fois que vous ajoutez une bibliothèque, sinon le code fonctionnera chez vous et nulle part ailleurs.

Quatre pannes fréquentes et leur diagnostic

L’erreur ModuleNotFoundError: No module named mistralai signifie presque toujours que le terminal n’est pas dans le bon environnement virtuel. Vérifiez-le avec which python, qui doit pointer vers votre venv, puis avec pip list | grep mistralai.

L’erreur ImportError: cannot import name 'Mistral' from 'mistralai' signale, elle, un code écrit pour la version 1 du SDK. Depuis la version 2.0, tous les imports passent par mistralai.client : écrivez from mistralai.client import Mistral. La leçon sur les versions du SDK détaille les autres changements.

Une erreur SSL ou réseau, quant à elle, trahit souvent un proxy d’entreprise placé entre vous et l’extérieur. Indiquez-le explicitement à pip :

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

Enfin, si l’installation refuse la version de Python, rappelez-vous que le SDK exige Python 3.10 au minimum depuis la version 2.0. Mettez Python à jour, ou installez pyenv pour faire cohabiter plusieurs versions sans toucher à l’interpréteur du système.

Points clés à retenir

• Installez le SDK avec pip install mistralai dans un environnement virtuel
• La version actuelle est la 3.7.0 (1er novembre 2026) ; le client s’importe par from mistralai.client import Mistral
• Vérifiez l’installation en listant les modèles disponibles
• Figez vos dépendances dans requirements.txt pour la reproductibilité
• Python 3.10 ou supérieur est requis