Skip to content
A fast, distributed, high performance gradient boosting (GBT, GBDT, GBRT, GBM or MART) framework based on decision tree algorithms, used for ranking, classification and many other machine learning tasks.
C++ Python R C Shell CMake Other
Branch: master
Clone or download
guolinke check sorted indices in Subset (#2510)
* Update sparse_bin.hpp

* check sorted in c_api

* fix python package

* fix tests

* fix test

* std::is_sorted

* Update
Latest commit 465d126 Oct 21, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.ci [ci] miniconda installer hotfix (#2511) Oct 16, 2019
.github reworked GitHub issue templates (#2492) Oct 6, 2019
.nuget [docs] updated Microsoft GitHub URL (#2152) May 8, 2019
R-package [docs] fixed miscellaneous typos in comments and documentation (#2496) Oct 7, 2019
compute @ 36c8913 [ci] update CI stuff (#2079) Apr 9, 2019
docker updated dockers (#2459) Oct 7, 2019
docs [docs] clarified support of LibSVM zero-based format files (#2504) Oct 14, 2019
examples Predefined bin thresholds (#2325) Sep 28, 2019
helpers [ci] fixed whitespace cpplint issue in auto-config (#2488) Oct 2, 2019
include/LightGBM reduce the buffer when using high dimensional data in distributed mod… Oct 15, 2019
pmml [docs][python] made OS detection more reliable and little docs improv… Jun 3, 2018
python-package check sorted indices in Subset (#2510) Oct 21, 2019
src check sorted indices in Subset (#2510) Oct 21, 2019
swig [Java] add missing JNI exception checks to fix warnings (#2405) Sep 26, 2019
tests check sorted indices in Subset (#2510) Oct 21, 2019
windows code refactoring: cost effective gradient boosting (#2407) Sep 26, 2019
.appveyor.yml [ci] removed temp fix for missing package (#2493) Oct 6, 2019
.editorconfig added editorconfig (#2403) Sep 16, 2019
.gitignore [tests] simplified test and added dumped data to gitignore (#2372) Sep 2, 2019
.gitmodules Initial GPU acceleration support for LightGBM (#368) Apr 9, 2017
.readthedocs.yml [docs][R] added R-package docs generation routines (#2176) Sep 1, 2019
.travis.yml [ci] use the latest versions of OSes at Travis (#2467) Sep 29, 2019
.vsts-ci.yml [ci] removed temp fix for missing package (#2493) Oct 6, 2019
CMakeLists.txt fixed minor issues with R package (#2167) May 12, 2019 Create (#803) Aug 18, 2017
LICENSE added editorconfig (#2403) Sep 16, 2019 [docs] added m2cgen in README (#2512) Oct 16, 2019
VERSION.txt new version number after release (#2469) Sep 29, 2019
build_r.R [docs][R] added R-package docs generation routines (#2176) Sep 1, 2019
build_r_site.R [docs][R] added R-package docs generation routines (#2176) Sep 1, 2019

LightGBM, Light Gradient Boosting Machine

Azure Pipelines Build Status Appveyor Build Status Travis Build Status Documentation Status License Python Versions PyPI Version Join Gitter at Slack

LightGBM is a gradient boosting framework that uses tree based learning algorithms. It is designed to be distributed and efficient with the following advantages:

  • Faster training speed and higher efficiency.
  • Lower memory usage.
  • Better accuracy.
  • Support of parallel and GPU learning.
  • Capable of handling large-scale data.

For further details, please refer to Features.

Benefitting from these advantages, LightGBM is being widely-used in many winning solutions of machine learning competitions.

Comparison experiments on public datasets show that LightGBM can outperform existing boosting frameworks on both efficiency and accuracy, with significantly lower memory consumption. What's more, parallel experiments show that LightGBM can achieve a linear speed-up by using multiple machines for training in specific settings.

Get Started and Documentation

Our primary documentation is at and is generated from this repository. If you are new to LightGBM, follow the installation instructions on that site.

Next you may want to read:

Documentation for contributors:


08/15/2017 : Optimal split for categorical features.

07/13/2017 : Gitter is available.

06/20/2017 : Python-package is on PyPI now.

06/09/2017 : LightGBM Slack team is available.

05/03/2017 : LightGBM v2 stable release.

04/10/2017 : LightGBM supports GPU-accelerated tree learning now. Please read our GPU Tutorial and Performance Comparison.

02/20/2017 : Update to LightGBM v2.

02/12/2017 : LightGBM v1 stable release.

01/08/2017 : Release R-package beta version, welcome to have a try and provide feedback.

12/05/2016 : Categorical Features as input directly (without one-hot coding).

12/02/2016 : Release Python-package beta version, welcome to have a try and provide feedback.

More detailed update logs : Key Events.

External (Unofficial) Repositories


JPMML (Java PMML converter):

Treelite (model compiler for efficient deployment):

m2cgen (model appliers for various languages):

leaves (Go model applier):

ONNXMLTools (ONNX converter):

SHAP (model output explainer):

MMLSpark (LightGBM on Spark):

ML.NET (.NET/C#-package):

LightGBM.NET (.NET/C#-package):

Dask-LightGBM (distributed and parallel Python-package):

Ruby gem:


How to Contribute

LightGBM has been developed and used by many active community members. Your help is very valuable to make it better for everyone.

  • Contribute to the tests to make it more reliable.
  • Contribute to the documentation to make it clearer for everyone.
  • Contribute to the examples to share your experience with other users.
  • Look for issues with tag "help wanted" and submit pull requests to address them.
  • Add your stories and experience to Awesome LightGBM. If LightGBM helped you in a machine learning competition or some research application, we want to hear about it!
  • Open an issue to report problems or recommend new features.

Microsoft Open Source Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact with any additional questions or comments.

Reference Papers

Guolin Ke, Qi Meng, Thomas Finley, Taifeng Wang, Wei Chen, Weidong Ma, Qiwei Ye, Tie-Yan Liu. "LightGBM: A Highly Efficient Gradient Boosting Decision Tree". Advances in Neural Information Processing Systems 30 (NIPS 2017), pp. 3149-3157.

Qi Meng, Guolin Ke, Taifeng Wang, Wei Chen, Qiwei Ye, Zhi-Ming Ma, Tie-Yan Liu. "A Communication-Efficient Parallel Algorithm for Decision Tree". Advances in Neural Information Processing Systems 29 (NIPS 2016), pp. 1279-1287.

Huan Zhang, Si Si and Cho-Jui Hsieh. "GPU Acceleration for Large-scale Tree Boosting". SysML Conference, 2018.

Note: If you use LightGBM in your GitHub projects, please add lightgbm in the requirements.txt.


This project is licensed under the terms of the MIT license. See LICENSE for additional details.

You can’t perform that action at this time.