Installer le SDK Python Mistral

Ce qu’il faut avoir sous la main

L’installation du SDK suppose trois choses : Python 3.9 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 version 2 du SDK, la V2, qui est la version actuelle et recommandée en avril 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 :

# Installer la dernière V2
pip install "mistralai>=2"

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

Au passage, pip tire trois dépendances que vous verrez apparaître dans la liste et qu’il est utile de reconnaître : httpx, le client HTTP asynchrone performant qui porte les appels réseau ; pydantic, qui valide et sérialise les données échangées ; et typing-extensions, qui assure la compatibilité des annotations de types selon la version de Python. 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 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.

Trois 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.

Une erreur SSL ou réseau, 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 V2 exige Python 3.9 au minimum. 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 V2 — c’est celle à utiliser pour tout nouveau projet
• Vérifiez l’installation en listant les modèles disponibles
• Figez vos dépendances dans requirements.txt pour la reproductibilité
• Python 3.9 ou supérieur est requis