Installer XGBoost en Python

XGBoost est une bibliothèque open source consacrée aux arbres de décision à gradient boosté. Pour l’utiliser avec Python, installez-la avec pip ou conda dans l’environnement où s’exécute votre projet. La compilation à partir des sources est une option avancée, utile si vous devez personnaliser la compilation ou utiliser une configuration non prise en charge par une version précompilée.

Choisir une méthode d’installation

Utilisez pip si votre projet s’appuie déjà sur pip et sur un environnement Python standard. Choisissez conda si vous gérez votre projet avec conda et souhaitez que ses outils d’environnement et de gestion des paquets prennent en charge ensemble les dépendances. Évitez de mélanger plusieurs gestionnaires de paquets dans un même environnement, sauf si vous comprenez comment celui-ci résout les paquets.

Sélectionnez ou activez d’abord l’environnement, puis utilisez son gestionnaire de paquets. Les commandes d’installation ci-dessous n’ont pas été exécutées dans le cadre de cette ébauche d’article. Avant l’installation, consultez le guide officiel d’installation de XGBoost et la documentation des versions pour connaître les instructions à jour ainsi que les combinaisons de versions de Python et de plateformes prises en charge.

Installer XGBoost avec pip

Dans le terminal associé à l’environnement Python que vous comptez utiliser, exécutez python -m pip install xgboost. La forme python -m pip associe pip à cet interpréteur, ce qui aide à éviter une installation dans une autre version de Python. Sur les systèmes où la commande s’appelle python3, utilisez plutôt python3 -m pip install xgboost.

Pour mettre à jour une installation pip existante, exécutez python -m pip install --upgrade xgboost dans le même environnement. Lisez les éventuels messages de pip concernant les dépendances ou la compatibilité, puis vérifiez l’installation en suivant l’étape ci-dessous.

Installer XGBoost avec conda

Activez l’environnement conda de votre projet, puis suivez la commande conda-forge indiquée dans le guide officiel d’installation de XGBoost, qui est actuellement conda install -c conda-forge py-xgboost. Cette commande sélectionne le canal conda-forge et le paquet Python. La disponibilité des paquets peut varier selon la plateforme et la version : consultez donc le guide avant d’installer ou de mettre à jour XGBoost, et utilisez le nom de paquet et le canal qu’il indique pour votre environnement.

Compiler XGBoost à partir des sources

La compilation à partir des sources s’adresse aux utilisateurs avancés qui doivent personnaliser XGBoost ou dont la plateforme et les besoins ne sont pas couverts par un paquet disponible. Consultez le guide officiel de compilation de XGBoost pour connaître les prérequis et les commandes correspondant à votre système d’exploitation et à la version utilisée. Ce guide couvre la compilation native et l’installation du paquet Python. Suivez ses instructions à jour plutôt qu’une procédure générique, car les prérequis et les commandes peuvent changer. Installez le paquet Python obtenu dans le même environnement que celui utilisé par votre projet.

Vérifier l’installation et résoudre les problèmes courants

Exécutez cette vérification autonome avec l’interpréteur Python sélectionné pour votre projet. Elle indique la version installée de XGBoost ou, si cet interpréteur ne trouve pas le paquet, affiche un message explicite en anglais.

import importlib.util

if importlib.util.find_spec("xgboost") is None:
    print("XGBoost is not installed in this Python environment.")
else:
    import xgboost

    print(f"XGBoost {xgboost.__version__}")

XGBoost is not installed in this Python environment.

Si la vérification indique que XGBoost n’est pas installé alors que vous venez de l’installer, comparez l’interpréteur utilisé pour l’installation avec celui qui exécute votre application. Avec pip, python -m pip show xgboost vérifie le paquet associé à cet interpréteur ; avec conda, conda list xgboost vérifie le contenu de l’environnement actif. Effectuez l’installation et la vérification dans le même environnement activé. Si l’environnement est bien le même, examinez l’erreur d’importation complète et consultez les instructions d’installation officielles correspondant à votre système d’exploitation, à votre version de Python et à votre version de XGBoost avant de modifier les dépendances.

Foire aux questions

Puis-je installer XGBoost dans un environnement virtuel ?

Oui. Activez d’abord l’environnement venv ou conda, installez XGBoost avec le gestionnaire de paquets de cet environnement, puis exécutez la vérification avec son interpréteur Python.

Quelles versions de Python et quelles plateformes sont prises en charge ?

La prise en charge dépend de la version de XGBoost et des paquets disponibles. Consultez la documentation officielle des versions et de l’installation pour connaître les versions de Python et les plateformes prises en charge par la version que vous prévoyez d’installer.

Puis-je utiliser XGBoost avec d’autres bibliothèques d’apprentissage automatique ?

XGBoost fournit un paquet Python qui peut être utilisé dans des projets Python avec d’autres bibliothèques. Pour une intégration précise, suivez la documentation à jour de la bibliothèque concernée et vérifiez que les versions installées sont compatibles.