lightgbm 2.1.2

LightGBM Python Package

Installation

Preparation

setuptools is needed.

For macOS users, gcc with OpenMP support must be installed first. Refer to Installation Guide for installing gcc with OpenMP support.

Note: 32-bit Python is not supported. Please install 64-bit version.

Install from PyPI Using pip

For Windows users, VC runtime is needed if Visual Studio (2015 or 2017) is not installed.

For macOS users, latest versions of LightGBM are built with g++-8 and cannot be launched on systems with g++-7 and earlier. You should update your g++ compiler if you don’t want to build from sources or install LightGBM 2.1.1 which is the last version built with g++-7.

Install wheel via pip install wheel first. After that download the wheel file and install from it:

pip install lightgbm

Build from Sources

pip install --no-binary :all: lightgbm

For Linux and macOS users, installation from sources requires installed CMake.

For macOS users, you need to specify compilers by runnig export CXX=g++-7 CC=gcc-7 (replace 7 with version of gcc installed on your machine) first.

For Windows users, Visual Studio (or MS Build) is needed. If you get any errors during installation, you may need to install CMake (version 3.8 or higher).

Build MPI Version

pip install lightgbm --install-option=--mpi

For Windows users, compilation with MinGW-w64 is not supported and CMake (version 3.8 or higher) is strongly required in this case.

Note: MPI libraries are needed: details for installation can be found in Installation Guide.

Build GPU Version

pip install lightgbm --install-option=--gpu

For Windows users, CMake (version 3.8 or higher) is strongly required in this case.

Note: Boost and OpenCL are needed: details for installation can be found in Installation Guide. You need to add OpenCL_INCLUDE_DIR to the environmental variable ‘PATH’ and export BOOST_ROOT before installation.

Also you may pass options to CMake via pip options, like

pip install lightgbm --install-option=--gpu --install-option="--opencl-include-dir=/usr/local/cuda/include/" --install-option="--opencl-library=/usr/local/cuda/lib64/libOpenCL.so"

All available options:

• boost-root

• boost-dir

• boost-include-dir

• boost-librarydir

• opencl-include-dir

• opencl-library

For more details see FindBoost and FindOpenCL.

Build HDFS Version

pip install lightgbm --install-option=--hdfs

For Windows users, CMake (version 3.8 or higher) is strongly required in this case.

Build with MinGW-w64 on Windows

pip install lightgbm --install-option=--mingw

Note: CMake and MinGW-w64 should be installed first.

Install from GitHub

For Linux and macOS users, installation from GitHub requires installed CMake.

For Windows users, Visual Studio (or MS Build) is needed. If you get any errors during installation and there is the warning WARNING:LightGBM:Compilation with MSBuild from existing solution file failed. in the log, you should install CMake (version 3.8 or higher).

git clone --recursive https://github.com/Microsoft/LightGBM.git
cd LightGBM/python-package
# export CXX=g++-7 CC=gcc-7  # for macOS users only (replace 7 with version of gcc installed on your machine)
python setup.py install

Note: sudo (or administrator rights in Windows) may be needed to perform the command.

Run python setup.py install --mpi to enable MPI support. For Windows users, compilation with MinGW-w64 is not supported and CMake (version 3.8 or higher) is strongly required in this case. MPI libraries are needed: details for installation can be found in Installation Guide.

Run python setup.py install --mingw if you want to use MinGW-w64 on Windows instead of Visual Studio. CMake and MinGW-w64 should be installed first.

Run python setup.py install --gpu to enable GPU support. For Windows users, CMake (version 3.8 or higher) is strongly required in this case. Boost and OpenCL are needed: details for installation can be found in Installation Guide. You can pass additional options to CMake: python setup.py install --gpu --opencl-include-dir=/usr/local/cuda/include/, see Build GPU Version for complete list of them.

Run python setup.py install --hdfs to enable HDFS support. For Windows users, CMake (version 3.8 or higher) is strongly required in this case.

If you get any errors during installation or due to any other reason, you may want to build dynamic library from sources by any method you prefer (see Installation Guide) and then run python setup.py install --precompile.

Examples

Refer to the walk through examples in Python guide folder.

Troubleshooting

In case you are facing any errors during the installation process, you can examine $HOME/LightGBM_compilation.log file, in which all operations are logged, to get more details about occurred problem. Also, please attach this file to the issue on GitHub to help faster indicate the cause of the error.

Refer to FAQ.

Developments

The code style of Python-package follows PEP 8. If you would like to make a contribution and not familiar with PEP 8, please check the PEP 8 style guide first. Otherwise, the check won’t pass. You should be careful about:

• E1 Indentation (check PEP 8 link above)

• E202 whitespace before and after brackets

• E225 missing whitespace around operator

• E226 missing whitespace around arithmetic operator

• E261 at least two spaces before inline comment

• E301 expected 1 blank line in front of and at the end of a method

• E302 expected 2 blank lines in front of and at the end of a function or a class

E501 (line too long) and W503 (line break occurred before a binary operator) can be ignored.