Installer le SDK Python Mistral

Prérequis techniques

Avant d’installer le SDK, assurez-vous de disposer de :

• Python 3.9 ou supérieur (vérifiez avec python --version)
• pip à jour (pip install --upgrade pip)
• Une clé API Mistral configurée en variable d’environnement (leçon précédente)

Si vous n’avez pas encore Python installé, téléchargez la dernière version stable depuis python.org ou utilisez votre gestionnaire de paquets système.

Créer un environnement virtuel

Travaillez toujours dans un environnement virtuel pour isoler les dépendances de chaque projet. Cette bonne pratique évite les conflits de versions entre vos différents projets Python.

# 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 activé, votre terminal affiche le nom de l’environnement entre parenthèses : (mistral-env).

Installer le SDK

Le SDK officiel Mistral s’installe en une seule commande :

pip install mistralai

Cette commande installe la version 2 du SDK (V2), qui est la version actuelle et recommandée en avril 2026. Pour vérifier l’installation :

pip show mistralai

Vous devriez voir le nom du package, sa version, et ses dépendances.

Installer une version spécifique

Si votre projet nécessite une version précise :

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

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

Dépendances installées

Le SDK Mistral installe automatiquement quelques dépendances :

• httpx : client HTTP asynchrone performant
• pydantic : validation des données et sérialisation
• typing-extensions : compatibilité des types Python

Vérifier que tout fonctionne

Créez un fichier test_mistral.py pour valider votre installation :

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}")

Exécutez-le :

python test_mistral.py

Si vous voyez la liste des modèles, votre SDK est correctement installé et votre clé API fonctionne.

Gestion des dépendances avec requirements.txt

Pour un projet collaboratif, figez vos dépendances dans un fichier requirements.txt :

pip freeze > requirements.txt

Vos collègues pourront alors reproduire votre environnement :

pip install -r requirements.txt

Résolution des problèmes courants

Erreur « ModuleNotFoundError: No module named mistralai »

Vérifiez que vous êtes bien dans votre environnement virtuel et que le SDK est installé :

which python    # Doit pointer vers votre venv
pip list | grep mistralai

Erreur SSL ou réseau

Si vous êtes derrière un proxy d’entreprise, configurez pip :

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

Conflit de version Python

Le SDK V2 nécessite Python 3.9+. Si vous avez une version antérieure, mettez Python à jour ou utilisez pyenv pour gérer plusieurs versions.

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