Skip to main content
======================
XGBoost Python Package
======================

|PyPI version|

Notes
=====

- Windows users: pip installation may not work on some Windows environments, and it may cause unexpected errors.

Installation from pip on Windows is therefore currently disabled for further investigation; please `install from Github <https://xgboost.readthedocs.io/en/latest/build.html>`_ instead.
- If you want to run XGBoost process in parallel using the fork backend for joblib/multiprocessing, you must build XGBoost without support for OpenMP by ``make no_omp=1``. Otherwise, use the forkserver (in Python 3.4) or spawn backend. See the `sklearn\_parallel.py <../demo/guide-python/sklearn_parallel.py>`__ demo.

Requirements
============

Since this package contains C++ source code, ``pip`` needs a C++ compiler from the system to compile the source code on-the-fly.

macOS
-----

On macOS, ``gcc@5`` is required as later versions remove support for OpenMP. `See here <https://github.com/dmlc/xgboost/issues/1501#issuecomment-292209578>`_ for more info.

Please install ``gcc@5`` from `Homebrew <https://brew.sh/>`_::

brew install gcc@5

After installing ``gcc@5``, set it as your compiler::

export CC = gcc-5
export CXX = g++-5

Linux
-----

Please install ``gcc``::

sudo apt-get install build-essential # Ubuntu/Debian
sudo yum groupinstall 'Development Tools' # CentOS/RHEL

Installation
============

>From `PyPI <https://pypi.python.org/pypi/xgboost>`_
---------------------------------------------------

For a stable version, install using ``pip``::

pip install xgboost

>From source
-----------

For an up-to-date version, `install from Github <https://xgboost.readthedocs.io/en/latest/build.html>`_:

- Run ``./build.sh`` in the root of the repo.
- Make sure you have `setuptools <https://pypi.python.org/pypi/setuptools>`_ installed: ``pip install setuptools``
- Install with ``cd python-package; python setup.py install`` from the root of the repo
- For Windows users, please use the Visual Studio project file under the `Windows folder <../windows/>`_. See also the `installation
tutorial <https://www.kaggle.com/c/otto-group-product-classification-challenge/forums/t/13043/run-xgboost-from-windows-and-python>`_ from Kaggle Otto Forum.
- Add MinGW to the system PATH in Windows if you are using the latest version of xgboost which requires compilation::

python
import os
os.environ['PATH'] = os.environ['PATH'] + ';C:\\Program Files\\mingw-w64\\x86_64-5.3.0-posix-seh-rt_v4-rev0\\mingw64\\bin'

Examples
========

- Refer also to the walk through example in `demo folder <https://github.com/dmlc/xgboost/tree/master/demo/guide-python>`_.
- See also the `example scripts <https://github.com/dmlc/xgboost/tree/master/demo/kaggle-higgs>`_ for Kaggle
Higgs Challenge, including `speedtest script <https://github.com/dmlc/xgboost/tree/master/demo/kaggle-higgs/speedtest.py>`_ on this dataset.

.. |PyPI version| image:: https://badge.fury.io/py/xgboost.svg
:target: http://badge.fury.io/py/xgboost


Metadata

Release files for xgboost 0.81

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xgboost 0.81
File Size Uploaded
xgboost-0.81.tar.gz 636.3 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for xgboost 0.81
File Interpreter ABI Platform
xgboost-0.81-py2.py3-none-win_amd64.whl Python 3, Python 2 none Windows x86-64 Details
xgboost-0.81-py2.py3-none-manylinux1_x86_64.whl Python 3, Python 2 none Linux glibc 2.5+ x86-64 Details

Total release size: 24.7 MB

Release files / xgboost-0.81.tar.gz

Download URL xgboost-0.81.tar.gz
Size 636.3 kB
Tags Source
SHA-256 checksum
How to use checksums
f7c8057610350b0b2f91e1ac7c034f2f03d233919d111759346559e628061e0c
BLAKE2b-256 checksum
How to use checksums
4f4c4969b10939c4557ae46e5569d07c0c7ce772b3d6b9c1401a6ed07059fdee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0

Release files / xgboost-0.81-py2.py3-none-win_amd64.whl

Download URL xgboost-0.81-py2.py3-none-win_amd64.whl
Size 7.4 MB
Tags Python 2 Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
e75863efa986f24819a5adf4a9f81a611d70d90164cc0a31a7178ba9f517a6d7
BLAKE2b-256 checksum
How to use checksums
1de75258cb787dc036f419ec57491decf8bfa89ab52c401b08b4b9228e43dc4c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0

Release files / xgboost-0.81-py2.py3-none-manylinux1_x86_64.whl

Download URL xgboost-0.81-py2.py3-none-manylinux1_x86_64.whl
Size 16.6 MB
Tags Linux glibc 2.5+ x86-64 Python 2 Python 3
SHA-256 checksum
How to use checksums
012d79d731f866b42600c127ba3cade2a1046396ba6f425976ecc8deb03bc67b
BLAKE2b-256 checksum
How to use checksums
54218b2ec99862903a6d3aed62ce156d21d114b8666e669c46d9e54041df9496
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.0

Release history Release notifications | RSS feed

3.4.1

7 release files

3.4.0

7 release files

3.3.0

6 release files

3.2.0

6 release files

3.1.3

6 release files

3.1.2

6 release files

3.1.1

6 release files

3.1.0

6 release files

3.0.5

8 release files

3.0.4

8 release files

3.0.3

8 release files

3.0.2

8 release files

3.0.1

8 release files

3.0.0

8 release files

2.1.4

8 release files

2.1.3

8 release files

2.1.2

8 release files

2.1.1

8 release files

2.1.0

8 release files

2.0.3

6 release files

2.0.2

6 release files

2.0.1

6 release files

2.0.0

6 release files

1.7.6

6 release files

1.7.5

6 release files

1.7.4

6 release files

1.7.3

6 release files

1.7.2

6 release files

1.7.1

6 release files

1.6.2

6 release files

1.6.1

6 release files

1.6.0

6 release files

1.5.2

5 release files

1.5.1

5 release files

1.5.0

5 release files

1.4.2

5 release files

1.4.1

5 release files

1.4.0

5 release files

1.3.3

5 release files

1.3.2

5 release files

1.3.1

5 release files

1.2.1

5 release files

1.2.0

4 release files

1.1.1

4 release files

1.1.0

4 release files

1.0.2

3 release files

1.0.1

3 release files

1.0.0

3 release files

0.90

3 release files

0.82

3 release files

This release

0.81 This release

3 release files

0.80

3 release files

0.71

1 release file

0.7.post2

0.7.post1

0.7

0.6

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page