lightgbm 2.0.7

LightGBM Python Package

Installation

Preparation

setuptools is needed.

For Mac OS X users, gcc with OpenMP support must be installed first. Refer to wiki 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 (2013, 2015 or 2017) is not installed.

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 Mac OS X users, installation from sources requires installed CMake.

For Mac OS X users, you need to specify compilers by runnig export CXX=g++-7 CC=gcc-7 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 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 gpu-support. You need to add OpenCL_INCLUDE_DIR to the environmental variable ‘PATH’ and export BOOST_ROOT before installation.

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 Mac OS X 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 Mac OS X users only
python setup.py install

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

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 gpu-support.

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

Refer to FAQ.

Developments

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

• E1 Indentation (check pep8 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 can be ignored (line too long).