LightGBM Python Package
Project description
Installation
Preparation
setuptools is needed.
For Mac OS X 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.
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 Installation Guide. 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
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 Installation Guide.
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).
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.0.11-py2.py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cc2ecadd34d7aa05e472a8c07d1e128cbc5c1723ef1bc21f7901b46fdb9125d9 |
|
MD5 | a3d1439fa5ca8a25a8a258c800b09cb7 |
|
BLAKE2b-256 | 309663a1d3c037020ac079e3bcd71611e327fecf9ffccf0cf2887c8beaa895ba |
Hashes for lightgbm-2.0.11-py2.py3-none-manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | de49547af9a0e5a2a9bd52896c4e57047bdbf105a57e7b4d4f016339b964e5a6 |
|
MD5 | 06019590b1c37bd7559e89d9b551216e |
|
BLAKE2b-256 | 1e04d7cad86b3a2895c2c10bbbf5c29cfcb82ba22e2927e74d182cdc391d9f4e |
Hashes for lightgbm-2.0.11-py2.py3-none-macosx_10_9_x86_64.macosx_10_10_x86_64.macosx_10_11_x86_64.macosx_10_12_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ebe39520de9328b5988ef9c6eb56584aef0b9f35a1b212eaefd9f7acc4040ac8 |
|
MD5 | a4535f515c657e0d558ad878fee994c8 |
|
BLAKE2b-256 | 8d9fec61187a6c67ec83313cc1d1b4dd506536c16f33416123d078191fe05613 |