thundergbm

KO | EN

gitlite — search

#python #nodejs #javascript #docker #shell #bot #java #php #compiler #elasticsearch #music #swift

★ 715 Open GitHub ↗

ThunderGBM: Fast GBDTs and Random Forests on GPUs

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Documentation Status](https://readthedocs.org/projects/thundergbm/badge/?version=latest)](https://thundergbm.readthedocs.org)
[![GitHub license](https://img.shields.io/badge/license-apache2-yellowgreen)](https://raw.githubusercontent.com/Xtra-Computing/thundergbm/master/LICENSE)
[![GitHub issues](https://img.shields.io/github/issues/xtra-computing/thundergbm.svg)](https://github.com/xtra-computing/thundergbm/issues)
[![PyPI version](https://badge.fury.io/py/thundergbm.svg)](https://badge.fury.io/py/thundergbm)
[![Downloads](https://pepy.tech/badge/thundergbm)](https://pepy.tech/project/thundergbm)

[Documentations](docs/index.md) | [Installation](docs/how-to.md#how-to-install-thundergbm) | [Parameters](docs/parameters.md) | [Python (scikit-learn) interface](python/README.md)

## What's new?
ThunderGBM won 2019 Best Paper Award from IEEE Transactions on Parallel and Distributed Systems by the IEEE Computer Society Publications Board (1 out of 987 submissions, for the work "Zeyi Wen^, Jiashuai Shi*, Bingsheng He, Jian Chen, Kotagiri Ramamohanarao, and Qinbin Li*, Exploiting GPUs for Efficient Gradient Boosting Decision Tree Training , IEEE Transactions on Parallel and Distributed Systems, vol. 30, no. 12, 2019, pp. 2706-2717."). see more details: [Best Paper Award Winners from IEEE](https://www.computer.org/publications/best-paper-award-winners), 
[News from NUS School of Computing](https://www.comp.nus.edu.sg/news/2020-ieee-tpds/)

## Overview
The mission of ThunderGBM is to help users easily and efficiently apply GBDTs and Random Forests to solve problems. ThunderGBM exploits GPUs to achieve high efficiency. Key features of ThunderGBM are as follows.
* Often by 10x times over other libraries.
* Support Python (scikit-learn) interfaces.
* Supported Operating System(s): Linux and Windows.
* Support classification, regression and ranking.

**Why accelerate GBDT and Random Forests**: A [survey](https://www.kaggle.com/amberthomas/kaggle-2017-survey-results) conducted by Kaggle in 2017 shows that 50%, 46% and 24% of the data mining and machine learning practitioners are users of Decision Trees, Random Forests and GBMs, respectively.

GBDTs and Random Forests are often used for creating state-of-the-art data science solutions. We've listed three winning solutions using GBDTs below. Please check out the [XGBoost website](https://github.com/dmlc/xgboost/blob/master/demo/README.md#machine-learning-challenge-winning-solutions) for more winning solutions and use cases. Here are some example successes of GDBTs and Random Forests:

- Halla Yang, 2nd place, [Recruit Coupon Purchase Prediction Challenge](https://www.kaggle.com/c/coupon-purchase-prediction), [Kaggle interview](http://blog.kaggle.com/2015/10/21/recruit-coupon-purchase-winners-interview-2nd-place-halla-yang/).
- Owen Zhang, 1st place, [Avito Context Ad Clicks competition](https://www.kaggle.com/c/avito-context-ad-clicks), [Kaggle interview](http://blog.kaggle.com/2015/08/26/avito-winners-interview-1st-place-owen-zhang/).
- Keiichi Kuroyanagi, 2nd place, [Airbnb New User Bookings](https://www.kaggle.com/c/airbnb-recruiting-new-user-bookings), [Kaggle interview](http://blog.kaggle.com/2016/03/17/airbnb-new-user-bookings-winners-interview-2nd-place-keiichi-kuroyanagi-keiku/).

## Getting Started

### Prerequisites
* cmake 2.8 or above 
    * gcc 4.8 or above for Linux | [CUDA](https://developer.nvidia.com/cuda-downloads) 9 or above
    * Visual C++ for Windows | CUDA 10

### Quick Install
* For Linux with CUDA 9.0
    * `pip install thundergbm`
    
* For Windows (64bit)
    - Download the Python wheel file (for Python3 or above)
    
        * [CUDA 10.0 - Win64](https://github.com/Xtra-Computing/thundergbm/blob/master/python/dist/thundergbm-0.3.12-py2-none-win_amd64.whl)

- Install the Python wheel file
    
        * `pip install thundergbm-0.3.4-py3-none-win_amd64.whl`
* Currently only support python3
* After you have installed thundergbm, you can import and use the classifier (similarly for regressor) by:
```python
from thundergbm import TGBMClassifier
clf = TGBMClassifier()
clf.fit(x, y)
```
### Build from source
```bash
git clone https://github.com/zeyiwen/thundergbm.git
cd thundergbm
#under the directory of thundergbm
git submodule init cub && git submodule update
```
### Build on Linux (build instructions for [Windows](docs/how-to.md#build-on-windows))
```bash
#under the directory of thundergbm
mkdir build && cd build && cmake .. && make -j
```

### Quick Start
```bash
./bin/thundergbm-train ../dataset/machine.conf
./bin/thundergbm-predict ../dataset/machine.conf
```
You will see `RMSE = 0.489562` after successful running.

MacOS is not supported, as Apple has [suspended support](https://www.forbes.com/sites/marcochiappetta/2018/12/11/apple-turns-its-back-on-customers-and-nvidia-with-macos-mojave/#5b8d3c7137e9) for some NVIDIA GPUs. We will consider supporting MacOS based on our user community feedbacks. Please stay tuned.

## How to cite ThunderGBM
If you use ThunderGBM in your paper, please cite our work ([TPDS](https://zeyiwen.github.io/papers/tpds19_gpugbdt.pdf) and [JMLR](https://github.com/Xtra-Computing/thundergbm/blob/master/thundergbm-full.pdf)).
```
@ARTICLE{8727750,
  author={Z. {Wen} and J. {Shi} and B. {He} and J. {Chen} and K. {Ramamohanarao} and Q. {Li}},
  journal={IEEE Transactions on Parallel and Distributed Systems}, 
  title={Exploiting GPUs for Efficient Gradient Boosting Decision Tree Training}, 
  year={2019},
  volume={30},
  number={12},
  pages={2706-2717},
  }

@article{wenthundergbm19,
 author = {Wen, Zeyi and Shi, Jiashuai and He, Bingsheng and Li, Qinbin and Chen, Jian},
 title = {{ThunderGBM}: Fast {GBDTs} and Random Forests on {GPUs}},
 journal = {Journal of Machine Learning Research},
 volume={21},
 year = {2020}
}

@inproceedings{xu2025scalagbm,
  author    = {Borui Xu and Zeyi Wen and Yao Chen and Weiguo Liu and Weng-Fai Wong and Bingsheng He},
  title     = {ScalaGBM: Memory Efficient GBDT Training for High-Dimensional Data on GPU},
  booktitle = {Proceedings of the 30th ACM SIGKDD International Conference on Knowledge Discovery and Data Mining (KDD)},
  year      = {2025}
}

```
### Related papers
* Zeyi Wen, Jiashuai Shi, Bingsheng He, Jian Chen, Kotagiri Ramamohanarao and Qinbin Li. Exploiting GPUs for Efficient Gradient Boosting Decision Tree Training. IEEE Transactions on Parallel and Distributed Systems (TPDS), accepted in May 2019. [pdf](https://zeyiwen.github.io/papers/tpds19_gpugbdt.pdf)

* Zeyi Wen, Hanfeng Liu, Jiashuai Shi, Qinbin Li, Bingsheng He, Jian Chen. ThunderGBM: Fast GBDTs and Random Forests on GPUs. Featured at JMLR MLOSS (Machine Learning Open Source Software). Year: 2020, Volume: 21, Issue: 108, Pages: 1−5. [pdf](https://github.com/Xtra-Computing/thundergbm/blob/master/thundergbm-full.pdf)

* Zeyi Wen, Bingsheng He, Kotagiri Ramamohanarao, Shengliang Lu, and Jiashuai Shi. Efficient Gradient Boosted Decision Tree Training on GPUs. The 32nd IEEE Intern
ational Parallel and Distributed Processing Symposium (IPDPS), pages 234-243, 2018. [pdf](https://www.comp.nus.edu.sg/~hebs/pub/IPDPS18-GPUGBDT.pdf)

* Borui Xu, Zeyi Wen, Yao Chen, Weiguo Liu, Weng-Fai Wong, and Bingsheng He. “ScalaGBM: Memory Efficient GBDT Training for High-Dimensional Data on GPU.” Proceedings of the 30th ACM SIGKDD International Conference on Knowledge Discovery and Data Mining (KDD), 2025.

## Key members of ThunderGBM
* [Zeyi Wen](https://zeyiwen.github.io), NUS (now at The University of Western Australia)
* Hanfeng Liu, GDUFS (a visting student at NUS)
* Jiashuai Shi, SCUT (a visiting student at NUS)
* Qinbin Li, NUS
* Advisor: [Bingsheng He](https://www.comp.nus.edu.sg/~hebs/), NUS
* Collaborators: Jian Chen (SCUT)

## Other information
* This work is supported by a MoE AcRF Tier 2 grant (MOE2017-T2-1-122) and an NUS startup grant in Singapore.

## Related libraries
* [ThunderSVM](https://github.com/Xtra-Computing/thundersvm), which is another *Thunder* serier software tool developed by our group.
* [XGBoost](https://github.com/dmlc/xgboost) | [LightGBM](https://github.com/Microsoft/LightGBM) | [CatBoost](https://github.com/catboost/catboost) | [cuML](https://github.com/rapidsai/cuml)

thundergbm

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README