LightGBM Python Package
Project description
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
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for lightgbm-2.1.2-py2.py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ba378fe3a4c312d2623161807604af6ff35c6ebfb379dfd285f896179efd1c46 |
|
MD5 | b92f2236e3a62b936756ee41ecbedf75 |
|
BLAKE2b-256 | cf2698fdda319d4bfcf47058c0862ad9fc47266d76547c7f1fbb4819c921eec7 |
Hashes for lightgbm-2.1.2-py2.py3-none-manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5f6f4b5b9cc9e46283d275d691f2d75382c1a93c38c7211949e4a5dfd40def3d |
|
MD5 | 8b3bdb75a28bce91b5dae4c6fc5b83eb |
|
BLAKE2b-256 | 248d783679697bdf1585dc96acfe7c8538d6fab33ad80e827cadb7b413e61da6 |
Hashes for lightgbm-2.1.2-py2.py3-none-macosx_10_9_x86_64.macosx_10_10_x86_64.macosx_10_11_x86_64.macosx_10_12_x86_64.macosx_10_13_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | eb7dabf3bbb2cafa32efed5b389313ef38d92b9d2ae02931bd880ae115d8a3cb |
|
MD5 | c1c4391b16b41200d797bb98f41c235c |
|
BLAKE2b-256 | c1b71b9f8d50927ee4297dfc0b238ec63621d4b600120f3c5a3c0261ba601036 |