XGBoost in Python installieren

XGBoost ist eine Open-Source-Bibliothek für Entscheidungsbäume mit Gradient Boosting. Um die Bibliothek mit Python zu verwenden, installieren Sie sie mit pip oder conda in der Umgebung, in der Ihr Projekt ausgeführt wird. Ein Build aus dem Quellcode ist eine fortgeschrittene Option, wenn Sie den Build anpassen oder eine Konfiguration verwenden müssen, die von einer verfügbaren Paketversion nicht unterstützt wird.

Installationsmethode auswählen

Verwenden Sie pip, wenn Ihr Projekt bereits pip und eine Standard-Python-Umgebung nutzt. Wählen Sie conda, wenn Sie Ihr Projekt mit conda verwalten und dessen Umgebungs- und Paketwerkzeuge gemeinsam für die Abhängigkeitsverwaltung einsetzen möchten. Verwenden Sie nicht mehrere Paketmanager in derselben Umgebung, es sei denn, Sie wissen, wie diese Umgebung Pakete auflöst.

Wählen oder aktivieren Sie zuerst die Umgebung und führen Sie anschließend den zugehörigen Paketmanager aus. Die folgenden Paketbefehle wurden im Rahmen dieses Artikelentwurfs nicht ausgeführt. Prüfen Sie vor der Installation die offizielle XGBoost-Installationsanleitung und die Dokumentation zur jeweiligen Version auf aktuelle Paketanweisungen sowie unterstützte Kombinationen aus Python-Version und Plattform.

XGBoost mit pip installieren

Führen Sie im Terminal der vorgesehenen Python-Umgebung den Befehl python -m pip install xgboost aus. Mit python -m pip verwenden Sie pip über genau diesen Interpreter. So lässt sich vermeiden, dass das Paket in einer anderen Python-Installation landet. Wenn der Befehl auf Ihrem System python3 lautet, verwenden Sie stattdessen python3 -m pip install xgboost.

Um eine bestehende pip-Installation zu aktualisieren, führen Sie in derselben Umgebung python -m pip install --upgrade xgboost aus. Beachten Sie Hinweise von pip zu Abhängigkeiten oder Kompatibilität und überprüfen Sie die Installation anschließend wie unten beschrieben.

XGBoost mit conda installieren

Aktivieren Sie die conda-Umgebung Ihres Projekts und folgen Sie dann dem conda-forge-Befehl in der offiziellen XGBoost-Installationsanleitung. Derzeit lautet er conda install -c conda-forge py-xgboost. Damit wählen Sie den conda-forge-Kanal und das Python-Paket aus. Die Verfügbarkeit von Paketen kann je nach Plattform und Version variieren. Prüfen Sie daher vor einer Installation oder Aktualisierung die Anleitung und verwenden Sie den dort für Ihre Umgebung aufgeführten Paketnamen und Kanal.

XGBoost aus dem Quellcode erstellen

Ein Build aus dem Quellcode richtet sich an fortgeschrittene Nutzer, die XGBoost anpassen müssen oder deren Plattform und Anforderungen durch kein verfügbares Paket abgedeckt werden. Die offizielle Anleitung zum Erstellen aus dem Quellcode enthält die Voraussetzungen und Befehle für Ihr Betriebssystem und die jeweilige Version. Sie beschreibt den nativen Build-Prozess und die Installation des Python-Pakets. Folgen Sie den aktuellen Schritten der Anleitung statt einer allgemeinen Befehlsfolge, da sich Build-Anforderungen und Befehle ändern können. Installieren Sie das daraus erstellte Python-Paket in derselben Umgebung, die Ihr Projekt verwendet.

Installation überprüfen und häufige Probleme beheben

Führen Sie diese eigenständige Prüfung mit dem Python-Interpreter aus, den Ihr Projekt verwendet. Sie gibt die installierte XGBoost-Version aus oder zeigt eine Meldung an, wenn dieser Interpreter das Paket nicht findet. Der Meldungstext im unveränderten Beispiel bleibt auf Englisch.

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.

Wenn die Prüfung meldet, dass XGBoost nicht installiert ist, obwohl Sie es installiert haben, vergleichen Sie den Interpreter bei der Installation mit dem Interpreter, der Ihre Anwendung ausführt. Mit pip prüft python -m pip show xgboost das Paket, das diesem Interpreter zugeordnet ist; mit conda prüft conda list xgboost die aktive Umgebung. Führen Sie Installation und Überprüfung in derselben aktivierten Umgebung aus. Stimmen die Umgebungen überein, verwenden Sie die vollständige Importfehlermeldung und lesen Sie die offizielle Installationsanleitung für Ihr Betriebssystem, Ihre Python-Version und Ihre XGBoost-Version, bevor Sie Abhängigkeiten ändern.

Häufig gestellte Fragen

Kann ich XGBoost in einer virtuellen Umgebung installieren?

Ja. Aktivieren Sie zuerst die venv- oder conda-Umgebung, installieren Sie XGBoost mit dem Paketmanager dieser Umgebung und führen Sie die Prüfung mit deren Python-Interpreter aus.

Welche Python-Versionen und Plattformen werden unterstützt?

Die Unterstützung hängt von der XGBoost-Version und den verfügbaren Paket-Builds ab. Prüfen Sie in der offiziellen Versions- und Installationsdokumentation, welche Python-Versionen und Plattformen für die geplante Version unterstützt werden.

Kann ich XGBoost zusammen mit anderen Machine-Learning-Bibliotheken verwenden?

XGBoost bietet ein Python-Paket und lässt sich in Python-Projekten zusammen mit anderen Bibliotheken verwenden. Informieren Sie sich für eine bestimmte Integration in der aktuellen Dokumentation der betreffenden Bibliothek und prüfen Sie, ob die installierten Versionen kompatibel sind.