Instalar XGBoost en Python

XGBoost es una biblioteca de código abierto para árboles de decisión potenciados por gradiente. Para usarla desde Python, instálala con pip o conda en el entorno donde se ejecuta tu proyecto. Compilarla desde el código fuente es una opción avanzada si necesitas personalizar la compilación o usar una configuración que no admite una versión empaquetada.

Elegir un método de instalación

Usa pip si tu proyecto ya utiliza pip y un entorno estándar de Python. Elige conda si gestionas el proyecto con conda y quieres que sus herramientas de entornos y paquetes administren las dependencias en conjunto. Evita combinar gestores de paquetes en un mismo entorno salvo que sepas cómo resuelve los paquetes.

Selecciona o activa primero el entorno y luego ejecuta su gestor de paquetes. Los comandos de paquetes que aparecen a continuación no se han ejecutado como parte de este borrador del artículo. Antes de instalar, consulta la guía oficial de instalación de XGBoost y la documentación de la versión para conocer las instrucciones actuales y las combinaciones compatibles de Python y plataformas.

Instalar XGBoost con pip

En el terminal del entorno de Python que quieras usar, ejecuta python -m pip install xgboost. Usar python -m pip vincula pip a ese intérprete, lo que ayuda a evitar que el paquete se instale en otra instalación de Python. En los sistemas donde el comando se llama python3, ejecuta python3 -m pip install xgboost.

Para actualizar una instalación de pip existente, ejecuta python -m pip install --upgrade xgboost en el mismo entorno. Lee los mensajes de pip sobre dependencias o compatibilidad y confirma la instalación con el paso de verificación que aparece más abajo.

Instalar XGBoost con conda

Activa el entorno conda de tu proyecto y sigue el comando de conda-forge indicado en la guía oficial de instalación de XGBoost, que actualmente es conda install -c conda-forge py-xgboost. Este comando selecciona el canal conda-forge y el paquete de Python. La disponibilidad del paquete puede variar según la plataforma y la versión, así que consulta la guía antes de instalar o actualizar; utiliza el nombre del paquete y el canal que indique para tu entorno.

Compilar XGBoost desde el código fuente

La compilación desde el código fuente está pensada para usuarios avanzados que necesitan personalizar XGBoost o cuya plataforma y requisitos no son compatibles con los paquetes disponibles. Consulta la guía oficial para compilar XGBoost desde el código fuente para conocer los requisitos previos y los comandos correspondientes a tu sistema operativo y versión. La guía abarca la compilación nativa y la instalación del paquete de Python; sigue sus pasos actuales en lugar de una secuencia genérica, ya que los requisitos y comandos de compilación pueden cambiar. Instala el paquete de Python resultante en el mismo entorno que utiliza tu proyecto.

Verificar la instalación y solucionar problemas comunes

Ejecuta esta comprobación autónoma con el intérprete de Python seleccionado para tu proyecto. Muestra la versión instalada de XGBoost o un mensaje claro si ese intérprete no encuentra el paquete. El mensaje del ejemplo permanece en inglés.

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 comprobación indica que XGBoost no está instalado después de haberlo instalado, compara el intérprete que usaste para instalarlo con el que ejecuta tu aplicación. Para pip, python -m pip show xgboost comprueba el paquete asociado a ese intérprete; para conda, conda list xgboost comprueba el entorno activo. Ejecuta la instalación y la verificación desde el mismo entorno activado. Si el entorno coincide, revisa el error de importación completo y consulta la guía oficial de instalación para tu sistema operativo, versión de Python y versión de XGBoost antes de cambiar las dependencias.

Preguntas frecuentes

¿Puedo instalar XGBoost en un entorno virtual?

Sí. Activa primero el entorno venv o conda, instala XGBoost con el gestor de paquetes de ese entorno y ejecuta la comprobación de verificación con su intérprete de Python.

¿Qué versiones de Python y plataformas son compatibles?

La compatibilidad depende de la versión de XGBoost y de los paquetes disponibles para cada plataforma. Consulta la documentación oficial de versiones e instalación para comprobar qué versiones de Python y plataformas admite la versión que quieres instalar.

¿Puedo usar XGBoost con otras bibliotecas de aprendizaje automático?

XGBoost ofrece un paquete de Python y se puede usar en proyectos de Python junto con otras bibliotecas. Para una integración concreta, sigue la documentación actual de la biblioteca correspondiente y confirma que las versiones instaladas sean compatibles.