| Name | lightgbm JSON |
| Version |
4.3.0
JSON |
| download |
| home_page | https://github.com/microsoft/LightGBM |
| Summary | LightGBM Python Package |
| upload_time | 2024-01-26 03:29:13 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.6 |
| license | The MIT License (MIT) Copyright (c) Microsoft Corporation Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
LightGBM Python-package
=======================
|License| |Python Versions| |PyPI Version| |Downloads| |API Docs|
Installation
------------
Preparation
'''''''''''
32-bit Python is not supported. Please install 64-bit version. If you have a strong need to install with 32-bit Python, refer to `Build 32-bit Version with 32-bit Python section <#build-32-bit-version-with-32-bit-python>`__.
`setuptools <https://pypi.org/project/setuptools>`_ is needed.
Install from `PyPI <https://pypi.org/project/lightgbm>`_
''''''''''''''''''''''''''''''''''''''''''''''''''''''''
.. code:: sh
pip install lightgbm
Compiled library that is included in the wheel file supports both **GPU** and **CPU** versions out of the box. This feature is experimental and available only for **Windows** and **Linux** currently. To use **GPU** version you only need to install OpenCL Runtime libraries. For NVIDIA and AMD GPU they are included in the ordinary drivers for your graphics card, so no action is required. If you would like your AMD or Intel CPU to act like a GPU (for testing and debugging) you can install `AMD APP SDK <https://github.com/microsoft/LightGBM/releases/download/v2.0.12/AMD-APP-SDKInstaller-v3.0.130.135-GA-windows-F-x64.exe>`_ on **Windows** and `PoCL <http://portablecl.org>`_ on **Linux**. Many modern Linux distributions provide packages for PoCL, look for ``pocl-opencl-icd`` on Debian-based distributions and ``pocl`` on RedHat-based distributions.
For **Windows** users, `VC runtime <https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads>`_ is needed if **Visual Studio** (2015 or newer) is not installed.
For **Linux** users, **glibc** >= 2.14 is required for LightGBM ``<=3.3.3`` and **glibc** >= 2.28 is required for newer versions. Also, in some rare cases, when you hit ``OSError: libgomp.so.1: cannot open shared object file: No such file or directory`` error during importing LightGBM, you need to install OpenMP runtime library separately (use your package manager and search for ``lib[g|i]omp`` for doing this).
For **macOS** (we provide wheels for 3 newest macOS versions) users:
- Starting from version 2.2.1, the library file in distribution wheels is built by the **Apple Clang** (Xcode_8.3.3 for versions 2.2.1 - 2.3.1, Xcode_9.4.1 for versions 2.3.2 - 3.3.2 and Xcode_11.7 from version 4.0.0) compiler. This means that you don't need to install the **gcc** compiler anymore. Instead of that you need to install the **OpenMP** library, which is required for running LightGBM on the system with the **Apple Clang** compiler. You can install the **OpenMP** library by the following command: ``brew install libomp``.
- For version smaller than 2.2.1 and not smaller than 2.1.2, **gcc-8** with **OpenMP** support must be installed first. Refer to `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#gcc>`__ for installation of **gcc-8** with **OpenMP** support.
- For version smaller than 2.1.2, **gcc-7** with **OpenMP** is required.
Use LightGBM with Dask
**********************
.. warning::
Dask-package is only tested on Linux.
To install all dependencies needed to use ``lightgbm.dask``, append ``[dask]``.
.. code:: sh
pip install 'lightgbm[dask]'
Use LightGBM with pandas
************************
To install all dependencies needed to use ``pandas`` in LightGBM, append ``[pandas]``.
.. code:: sh
pip install 'lightgbm[pandas]'
Use LightGBM with scikit-learn
******************************
To install all dependencies needed to use ``scikit-learn`` in LightGBM, append ``[scikit-learn]``.
.. code:: sh
pip install 'lightgbm[scikit-learn]'
Build from Sources
******************
.. code:: sh
pip install --no-binary lightgbm lightgbm
For **Linux** and **macOS** users, installation from sources requires installed `CMake`_.
For **Linux** users, **glibc** >= 2.28 is required. Also, in some rare cases you may need to install OpenMP runtime library separately (use your package manager and search for ``lib[g|i]omp`` for doing this).
For **macOS** users, you can perform installation either with **Apple Clang** or **gcc**.
- In case you prefer **Apple Clang**, you should install **OpenMP** (details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#apple-clang>`__) first and **CMake** version 3.16 or higher is required.
- In case you prefer **gcc**, you need to install it (details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#gcc>`__) and specify compilers by running ``export CXX=g++-7 CC=gcc-7`` (replace "7" with version of **gcc** installed on your machine) first.
For **Windows** users, **Visual Studio** (or `VS Build Tools <https://visualstudio.microsoft.com/downloads/>`_) is needed. If you get any errors during installation, you may need to install `CMake`_ (version 3.8 or higher).
Build Threadless Version
~~~~~~~~~~~~~~~~~~~~~~~~
.. code:: sh
pip install lightgbm --config-settings=cmake.define.USE_OPENMP=OFF
All requirements, except the **OpenMP** requirement, from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well.
It is **strongly not recommended** to use this version of LightGBM!
Build MPI Version
~~~~~~~~~~~~~~~~~
.. code:: sh
pip install lightgbm --config-settings=cmake.define.USE_MPI=ON
All requirements from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well.
For **Windows** users, compilation with **MinGW-w64** is not supported and `CMake`_ (version 3.8 or higher) is strongly required.
**MPI** libraries are needed: details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#build-mpi-version>`__.
Build GPU Version
~~~~~~~~~~~~~~~~~
.. code:: sh
pip install lightgbm --config-settings=cmake.define.USE_GPU=ON
All requirements from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well.
For **Windows** users, `CMake`_ (version 3.8 or higher) is strongly required.
**Boost** and **OpenCL** are needed: details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#build-gpu-version>`__. Almost always you also need to pass ``OpenCL_INCLUDE_DIR``, ``OpenCL_LIBRARY`` options for **Linux** and ``BOOST_ROOT``, ``BOOST_LIBRARYDIR`` options for **Windows** to **CMake** via ``pip`` options, like
.. code:: sh
pip install lightgbm \
--config-settings=cmake.define.USE_GPU=ON \
--config-settings=cmake.define.OpenCL_INCLUDE_DIR="/usr/local/cuda/include/" \
--config-settings=cmake.define.OpenCL_LIBRARY="/usr/local/cuda/lib64/libOpenCL.so"
All available options that can be passed via ``cmake.define.{option}``.
- Boost_ROOT
- Boost_DIR
- Boost_INCLUDE_DIR
- BOOST_LIBRARYDIR
- OpenCL_INCLUDE_DIR
- OpenCL_LIBRARY
For more details see `FindBoost <https://cmake.org/cmake/help/latest/module/FindBoost.html>`__ and `FindOpenCL <https://cmake.org/cmake/help/latest/module/FindOpenCL.html>`__.
Build CUDA Version
~~~~~~~~~~~~~~~~~~
.. code:: sh
pip install lightgbm --config-settings=cmake.define.USE_CUDA=ON
All requirements from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well, and `CMake`_ (version 3.16 or higher) is strongly required.
**CUDA** library (version 10.0 or higher) is needed: details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#build-cuda-version-experimental>`__.
To use the CUDA version within Python, pass ``{"device": "cuda"}`` respectively in parameters.
Build HDFS Version
~~~~~~~~~~~~~~~~~~
.. code:: sh
pip install lightgbm --config-settings=cmake.define.USE_HDFS=ON
All requirements from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well.
**HDFS** library is needed: details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#build-hdfs-version>`__.
Note that the installation process of HDFS version was tested only on **Linux**.
Build with MinGW-w64 on Windows
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. code:: sh
# in sh.exe, git bash, or other Unix-like shell
export CMAKE_GENERATOR='MinGW Makefiles'
pip install lightgbm --config-settings=cmake.define.CMAKE_SH=CMAKE_SH-NOTFOUND
`CMake`_ and `MinGW-w64 <https://www.mingw-w64.org/>`_ should be installed first.
It is recommended to use **Visual Studio** for its better multithreading efficiency in **Windows** for many-core systems
(see `Question 4 <https://github.com/microsoft/LightGBM/blob/master/docs/FAQ.rst#4-i-am-using-windows-should-i-use-visual-studio-or-mingw-for-compiling-lightgbm>`__ and `Question 8 <https://github.com/microsoft/LightGBM/blob/master/docs/FAQ.rst#8-cpu-usage-is-low-like-10-in-windows-when-using-lightgbm-on-very-large-datasets-with-many-core-systems>`__).
Build 32-bit Version with 32-bit Python
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. code:: sh
# in sh.exe, git bash, or other Unix-like shell
export CMAKE_GENERATOR='Visual Studio 17 2022'
export CMAKE_GENERATOR_PLATFORM='Win32'
pip install --no-binary lightgbm lightgbm
By default, installation in environment with 32-bit Python is prohibited. However, you can remove this prohibition on your own risk by passing ``bit32`` option.
It is **strongly not recommended** to use this version of LightGBM!
Build with Time Costs Output
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. code:: sh
pip install lightgbm --config-settings=cmake.define.USE_TIMETAG=ON
Use this option to make LightGBM output time costs for different internal routines, to investigate and benchmark its performance.
Install from `conda-forge channel <https://anaconda.org/conda-forge/lightgbm>`_
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
If you use ``conda`` to manage Python dependencies, you can install LightGBM using ``conda install``.
We strongly recommend installation from the ``conda-forge`` channel and not from the ``default`` one due to many reasons. The main ones are less time delay for new releases, greater number of supported architectures and better handling of dependency conflicts, especially workaround for OpenMP is crucial for LightGBM. More details can be found in `this comment <https://github.com/microsoft/LightGBM/issues/4948#issuecomment-1013766397>`_.
**Note**: The `lightgbm conda-forge feedstock <https://github.com/conda-forge/lightgbm-feedstock>`_ is not maintained by LightGBM maintainers.
.. code:: sh
conda install -c conda-forge lightgbm
Install from GitHub
'''''''''''''''''''
All requirements from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well.
For **Windows** users, 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).
.. code:: sh
git clone --recursive https://github.com/microsoft/LightGBM.git
# export CXX=g++-7 CC=gcc-7 # macOS users, if you decided to compile with gcc, don't forget to specify compilers (replace "7" with version of gcc installed on your machine)
sh ./build-python.sh install
Note: ``sudo`` (or administrator rights in **Windows**) may be needed to perform the command.
Run ``sh ./build-python.sh install --nomp`` to disable **OpenMP** support. All requirements from `Build Threadless Version section <#build-threadless-version>`__ apply for this installation option as well.
Run ``sh ./build-python.sh install --mpi`` to enable **MPI** support. All requirements from `Build MPI Version section <#build-mpi-version>`__ apply for this installation option as well.
Run ``sh ./build-python.sh install --mingw``, if you want to use **MinGW-w64** on **Windows** instead of **Visual Studio**. All requirements from `Build with MinGW-w64 on Windows section <#build-with-mingw-w64-on-windows>`__ apply for this installation option as well.
Run ``sh ./build-python.sh install --gpu`` to enable GPU support. All requirements from `Build GPU Version section <#build-gpu-version>`__ apply for this installation option as well. To pass additional options to **CMake** use the following syntax: ``sh ./build-python.sh install --gpu --opencl-include-dir="/usr/local/cuda/include/"``, see `Build GPU Version section <#build-gpu-version>`__ for the complete list of them.
Run ``sh ./build-python.sh install --cuda`` to enable CUDA support. All requirements from `Build CUDA Version section <#build-cuda-version>`__ apply for this installation option as well.
Run ``sh ./build-python.sh install --hdfs`` to enable HDFS support. All requirements from `Build HDFS Version section <#build-hdfs-version>`__ apply for this installation option as well.
Run ``sh ./build-python.sh install --bit32``, if you want to use 32-bit version. All requirements from `Build 32-bit Version with 32-bit Python section <#build-32-bit-version-with-32-bit-python>`__ apply for this installation option as well.
Run ``sh ./build-python.sh install --time-costs``, if you want to output time costs for different internal routines. All requirements from `Build with Time Costs Output section <#build-with-time-costs-output>`__ apply for this installation option as well.
If you get any errors during installation or due to any other reasons, you may want to build dynamic library from sources by any method you prefer (see `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst>`__) and then just run ``sh ./build-python.sh install --precompile``.
Build Wheel File
****************
You can use ``sh ./build-python.sh install bdist_wheel`` to build a wheel file but not install it.
That script requires some dependencies like ``build``, ``scikit-build-core``, and ``wheel``.
In environments with restricted or no internt access, install those tools and then pass ``--no-isolation``.
.. code:: sh
sh ./build-python.sh bdist_wheel --no-isolation
Build With MSBuild
******************
To use ``MSBuild`` (Windows-only), first build ``lib_lightgbm.dll`` by running the following from the root of the repo.
.. code:: sh
MSBuild.exe windows/LightGBM.sln /p:Configuration=DLL /p:Platform=x64 /p:PlatformToolset=v143
Then install the Python package using that library.
.. code:: sh
sh ./build-python.sh install --precompile
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 <https://github.com/microsoft/LightGBM/tree/master/docs/FAQ.rst>`_.
Examples
--------
Refer to the walk through examples in `Python guide folder <https://github.com/microsoft/LightGBM/tree/master/examples/python-guide>`_.
Development Guide
-----------------
The code style of Python-package follows `PEP 8 <https://www.python.org/dev/peps/pep-0008/>`_.
The package's documentation strings (docstrings) are written in the `numpydoc style <https://numpydoc.readthedocs.io/en/latest/format.html>`_.
To check that a contribution to the package matches its style expectations, run the following from the root of the repo.
.. code:: sh
sh .ci/lint-python.sh
.. |License| image:: https://img.shields.io/github/license/microsoft/lightgbm.svg
:target: https://github.com/microsoft/LightGBM/blob/master/LICENSE
.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/lightgbm.svg?logo=python&logoColor=white
:target: https://pypi.org/project/lightgbm
.. |PyPI Version| image:: https://img.shields.io/pypi/v/lightgbm.svg?logo=pypi&logoColor=white
:target: https://pypi.org/project/lightgbm
.. |Downloads| image:: https://pepy.tech/badge/lightgbm
:target: https://pepy.tech/project/lightgbm
.. |API Docs| image:: https://readthedocs.org/projects/lightgbm/badge/?version=latest
:target: https://lightgbm.readthedocs.io/en/latest/Python-API.html
.. _CMake: https://cmake.org/
Raw data
{
"_id": null,
"home_page": "https://github.com/microsoft/LightGBM",
"name": "lightgbm",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "Yu Shi <yushi@microsoft.com>",
"keywords": "",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/74/d1/2e4b02e4611ab36647639c4eea8c4520bb90f948563e00a3bec583a9f9f5/lightgbm-4.3.0.tar.gz",
"platform": null,
"description": "LightGBM Python-package\n=======================\n\n|License| |Python Versions| |PyPI Version| |Downloads| |API Docs|\n\nInstallation\n------------\n\nPreparation\n'''''''''''\n\n32-bit Python is not supported. Please install 64-bit version. If you have a strong need to install with 32-bit Python, refer to `Build 32-bit Version with 32-bit Python section <#build-32-bit-version-with-32-bit-python>`__.\n\n`setuptools <https://pypi.org/project/setuptools>`_ is needed.\n\nInstall from `PyPI <https://pypi.org/project/lightgbm>`_\n''''''''''''''''''''''''''''''''''''''''''''''''''''''''\n\n.. code:: sh\n\n pip install lightgbm\n\nCompiled library that is included in the wheel file supports both **GPU** and **CPU** versions out of the box. This feature is experimental and available only for **Windows** and **Linux** currently. To use **GPU** version you only need to install OpenCL Runtime libraries. For NVIDIA and AMD GPU they are included in the ordinary drivers for your graphics card, so no action is required. If you would like your AMD or Intel CPU to act like a GPU (for testing and debugging) you can install `AMD APP SDK <https://github.com/microsoft/LightGBM/releases/download/v2.0.12/AMD-APP-SDKInstaller-v3.0.130.135-GA-windows-F-x64.exe>`_ on **Windows** and `PoCL <http://portablecl.org>`_ on **Linux**. Many modern Linux distributions provide packages for PoCL, look for ``pocl-opencl-icd`` on Debian-based distributions and ``pocl`` on RedHat-based distributions.\n\nFor **Windows** users, `VC runtime <https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads>`_ is needed if **Visual Studio** (2015 or newer) is not installed.\n\nFor **Linux** users, **glibc** >= 2.14 is required for LightGBM ``<=3.3.3`` and **glibc** >= 2.28 is required for newer versions. Also, in some rare cases, when you hit ``OSError: libgomp.so.1: cannot open shared object file: No such file or directory`` error during importing LightGBM, you need to install OpenMP runtime library separately (use your package manager and search for ``lib[g|i]omp`` for doing this).\n\nFor **macOS** (we provide wheels for 3 newest macOS versions) users:\n\n- Starting from version 2.2.1, the library file in distribution wheels is built by the **Apple Clang** (Xcode_8.3.3 for versions 2.2.1 - 2.3.1, Xcode_9.4.1 for versions 2.3.2 - 3.3.2 and Xcode_11.7 from version 4.0.0) compiler. This means that you don't need to install the **gcc** compiler anymore. Instead of that you need to install the **OpenMP** library, which is required for running LightGBM on the system with the **Apple Clang** compiler. You can install the **OpenMP** library by the following command: ``brew install libomp``.\n\n- For version smaller than 2.2.1 and not smaller than 2.1.2, **gcc-8** with **OpenMP** support must be installed first. Refer to `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#gcc>`__ for installation of **gcc-8** with **OpenMP** support.\n\n- For version smaller than 2.1.2, **gcc-7** with **OpenMP** is required.\n\nUse LightGBM with Dask\n**********************\n\n.. warning::\n\n Dask-package is only tested on Linux.\n\nTo install all dependencies needed to use ``lightgbm.dask``, append ``[dask]``.\n\n.. code:: sh\n\n pip install 'lightgbm[dask]'\n\nUse LightGBM with pandas\n************************\n\nTo install all dependencies needed to use ``pandas`` in LightGBM, append ``[pandas]``.\n\n.. code:: sh\n\n pip install 'lightgbm[pandas]'\n\nUse LightGBM with scikit-learn\n******************************\n\nTo install all dependencies needed to use ``scikit-learn`` in LightGBM, append ``[scikit-learn]``.\n\n.. code:: sh\n\n pip install 'lightgbm[scikit-learn]'\n\nBuild from Sources\n******************\n\n.. code:: sh\n\n pip install --no-binary lightgbm lightgbm\n\nFor **Linux** and **macOS** users, installation from sources requires installed `CMake`_.\n\nFor **Linux** users, **glibc** >= 2.28 is required. Also, in some rare cases you may need to install OpenMP runtime library separately (use your package manager and search for ``lib[g|i]omp`` for doing this).\n\nFor **macOS** users, you can perform installation either with **Apple Clang** or **gcc**.\n\n- In case you prefer **Apple Clang**, you should install **OpenMP** (details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#apple-clang>`__) first and **CMake** version 3.16 or higher is required.\n\n- In case you prefer **gcc**, you need to install it (details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#gcc>`__) and specify compilers by running ``export CXX=g++-7 CC=gcc-7`` (replace \"7\" with version of **gcc** installed on your machine) first.\n\nFor **Windows** users, **Visual Studio** (or `VS Build Tools <https://visualstudio.microsoft.com/downloads/>`_) is needed. If you get any errors during installation, you may need to install `CMake`_ (version 3.8 or higher).\n\nBuild Threadless Version\n~~~~~~~~~~~~~~~~~~~~~~~~\n\n.. code:: sh\n\n pip install lightgbm --config-settings=cmake.define.USE_OPENMP=OFF\n\nAll requirements, except the **OpenMP** requirement, from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well.\n\nIt is **strongly not recommended** to use this version of LightGBM!\n\nBuild MPI Version\n~~~~~~~~~~~~~~~~~\n\n.. code:: sh\n\n pip install lightgbm --config-settings=cmake.define.USE_MPI=ON\n\nAll requirements from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well.\n\nFor **Windows** users, compilation with **MinGW-w64** is not supported and `CMake`_ (version 3.8 or higher) is strongly required.\n\n**MPI** libraries are needed: details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#build-mpi-version>`__.\n\nBuild GPU Version\n~~~~~~~~~~~~~~~~~\n\n.. code:: sh\n\n pip install lightgbm --config-settings=cmake.define.USE_GPU=ON\n\nAll requirements from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well.\n\nFor **Windows** users, `CMake`_ (version 3.8 or higher) is strongly required.\n\n**Boost** and **OpenCL** are needed: details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#build-gpu-version>`__. Almost always you also need to pass ``OpenCL_INCLUDE_DIR``, ``OpenCL_LIBRARY`` options for **Linux** and ``BOOST_ROOT``, ``BOOST_LIBRARYDIR`` options for **Windows** to **CMake** via ``pip`` options, like\n\n.. code:: sh\n\n pip install lightgbm \\\n --config-settings=cmake.define.USE_GPU=ON \\\n --config-settings=cmake.define.OpenCL_INCLUDE_DIR=\"/usr/local/cuda/include/\" \\\n --config-settings=cmake.define.OpenCL_LIBRARY=\"/usr/local/cuda/lib64/libOpenCL.so\"\n\nAll available options that can be passed via ``cmake.define.{option}``.\n\n- Boost_ROOT\n\n- Boost_DIR\n\n- Boost_INCLUDE_DIR\n\n- BOOST_LIBRARYDIR\n\n- OpenCL_INCLUDE_DIR\n\n- OpenCL_LIBRARY\n\nFor more details see `FindBoost <https://cmake.org/cmake/help/latest/module/FindBoost.html>`__ and `FindOpenCL <https://cmake.org/cmake/help/latest/module/FindOpenCL.html>`__.\n\nBuild CUDA Version\n~~~~~~~~~~~~~~~~~~\n\n.. code:: sh\n\n pip install lightgbm --config-settings=cmake.define.USE_CUDA=ON\n\nAll requirements from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well, and `CMake`_ (version 3.16 or higher) is strongly required.\n\n**CUDA** library (version 10.0 or higher) is needed: details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#build-cuda-version-experimental>`__.\n\nTo use the CUDA version within Python, pass ``{\"device\": \"cuda\"}`` respectively in parameters.\n\nBuild HDFS Version\n~~~~~~~~~~~~~~~~~~\n\n.. code:: sh\n\n pip install lightgbm --config-settings=cmake.define.USE_HDFS=ON\n\nAll requirements from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well.\n\n**HDFS** library is needed: details for installation can be found in `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst#build-hdfs-version>`__.\n\nNote that the installation process of HDFS version was tested only on **Linux**.\n\nBuild with MinGW-w64 on Windows\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n.. code:: sh\n\n # in sh.exe, git bash, or other Unix-like shell\n export CMAKE_GENERATOR='MinGW Makefiles'\n pip install lightgbm --config-settings=cmake.define.CMAKE_SH=CMAKE_SH-NOTFOUND\n\n`CMake`_ and `MinGW-w64 <https://www.mingw-w64.org/>`_ should be installed first.\n\nIt is recommended to use **Visual Studio** for its better multithreading efficiency in **Windows** for many-core systems\n(see `Question 4 <https://github.com/microsoft/LightGBM/blob/master/docs/FAQ.rst#4-i-am-using-windows-should-i-use-visual-studio-or-mingw-for-compiling-lightgbm>`__ and `Question 8 <https://github.com/microsoft/LightGBM/blob/master/docs/FAQ.rst#8-cpu-usage-is-low-like-10-in-windows-when-using-lightgbm-on-very-large-datasets-with-many-core-systems>`__).\n\nBuild 32-bit Version with 32-bit Python\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n.. code:: sh\n\n # in sh.exe, git bash, or other Unix-like shell\n export CMAKE_GENERATOR='Visual Studio 17 2022'\n export CMAKE_GENERATOR_PLATFORM='Win32'\n pip install --no-binary lightgbm lightgbm\n\nBy default, installation in environment with 32-bit Python is prohibited. However, you can remove this prohibition on your own risk by passing ``bit32`` option.\n\nIt is **strongly not recommended** to use this version of LightGBM!\n\nBuild with Time Costs Output\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n.. code:: sh\n\n pip install lightgbm --config-settings=cmake.define.USE_TIMETAG=ON\n\nUse this option to make LightGBM output time costs for different internal routines, to investigate and benchmark its performance.\n\nInstall from `conda-forge channel <https://anaconda.org/conda-forge/lightgbm>`_\n'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''\n\nIf you use ``conda`` to manage Python dependencies, you can install LightGBM using ``conda install``.\n\nWe strongly recommend installation from the ``conda-forge`` channel and not from the ``default`` one due to many reasons. The main ones are less time delay for new releases, greater number of supported architectures and better handling of dependency conflicts, especially workaround for OpenMP is crucial for LightGBM. More details can be found in `this comment <https://github.com/microsoft/LightGBM/issues/4948#issuecomment-1013766397>`_.\n\n**Note**: The `lightgbm conda-forge feedstock <https://github.com/conda-forge/lightgbm-feedstock>`_ is not maintained by LightGBM maintainers.\n\n.. code:: sh\n\n conda install -c conda-forge lightgbm\n\nInstall from GitHub\n'''''''''''''''''''\n\nAll requirements from `Build from Sources section <#build-from-sources>`__ apply for this installation option as well.\n\nFor **Windows** users, 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).\n\n.. code:: sh\n\n git clone --recursive https://github.com/microsoft/LightGBM.git\n # export CXX=g++-7 CC=gcc-7 # macOS users, if you decided to compile with gcc, don't forget to specify compilers (replace \"7\" with version of gcc installed on your machine)\n sh ./build-python.sh install\n\nNote: ``sudo`` (or administrator rights in **Windows**) may be needed to perform the command.\n\nRun ``sh ./build-python.sh install --nomp`` to disable **OpenMP** support. All requirements from `Build Threadless Version section <#build-threadless-version>`__ apply for this installation option as well.\n\nRun ``sh ./build-python.sh install --mpi`` to enable **MPI** support. All requirements from `Build MPI Version section <#build-mpi-version>`__ apply for this installation option as well.\n\nRun ``sh ./build-python.sh install --mingw``, if you want to use **MinGW-w64** on **Windows** instead of **Visual Studio**. All requirements from `Build with MinGW-w64 on Windows section <#build-with-mingw-w64-on-windows>`__ apply for this installation option as well.\n\nRun ``sh ./build-python.sh install --gpu`` to enable GPU support. All requirements from `Build GPU Version section <#build-gpu-version>`__ apply for this installation option as well. To pass additional options to **CMake** use the following syntax: ``sh ./build-python.sh install --gpu --opencl-include-dir=\"/usr/local/cuda/include/\"``, see `Build GPU Version section <#build-gpu-version>`__ for the complete list of them.\n\nRun ``sh ./build-python.sh install --cuda`` to enable CUDA support. All requirements from `Build CUDA Version section <#build-cuda-version>`__ apply for this installation option as well.\n\nRun ``sh ./build-python.sh install --hdfs`` to enable HDFS support. All requirements from `Build HDFS Version section <#build-hdfs-version>`__ apply for this installation option as well.\n\nRun ``sh ./build-python.sh install --bit32``, if you want to use 32-bit version. All requirements from `Build 32-bit Version with 32-bit Python section <#build-32-bit-version-with-32-bit-python>`__ apply for this installation option as well.\n\nRun ``sh ./build-python.sh install --time-costs``, if you want to output time costs for different internal routines. All requirements from `Build with Time Costs Output section <#build-with-time-costs-output>`__ apply for this installation option as well.\n\nIf you get any errors during installation or due to any other reasons, you may want to build dynamic library from sources by any method you prefer (see `Installation Guide <https://github.com/microsoft/LightGBM/blob/master/docs/Installation-Guide.rst>`__) and then just run ``sh ./build-python.sh install --precompile``.\n\nBuild Wheel File\n****************\n\nYou can use ``sh ./build-python.sh install bdist_wheel`` to build a wheel file but not install it.\n\nThat script requires some dependencies like ``build``, ``scikit-build-core``, and ``wheel``.\nIn environments with restricted or no internt access, install those tools and then pass ``--no-isolation``.\n\n.. code:: sh\n\n sh ./build-python.sh bdist_wheel --no-isolation\n\nBuild With MSBuild\n******************\n\nTo use ``MSBuild`` (Windows-only), first build ``lib_lightgbm.dll`` by running the following from the root of the repo.\n\n.. code:: sh\n\n MSBuild.exe windows/LightGBM.sln /p:Configuration=DLL /p:Platform=x64 /p:PlatformToolset=v143\n\nThen install the Python package using that library.\n\n.. code:: sh\n\n sh ./build-python.sh install --precompile\n\nTroubleshooting\n---------------\n\nIn 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.\n\nRefer to `FAQ <https://github.com/microsoft/LightGBM/tree/master/docs/FAQ.rst>`_.\n\nExamples\n--------\n\nRefer to the walk through examples in `Python guide folder <https://github.com/microsoft/LightGBM/tree/master/examples/python-guide>`_.\n\nDevelopment Guide\n-----------------\n\nThe code style of Python-package follows `PEP 8 <https://www.python.org/dev/peps/pep-0008/>`_.\n\nThe package's documentation strings (docstrings) are written in the `numpydoc style <https://numpydoc.readthedocs.io/en/latest/format.html>`_.\n\nTo check that a contribution to the package matches its style expectations, run the following from the root of the repo.\n\n.. code:: sh\n\n sh .ci/lint-python.sh\n\n.. |License| image:: https://img.shields.io/github/license/microsoft/lightgbm.svg\n :target: https://github.com/microsoft/LightGBM/blob/master/LICENSE\n.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/lightgbm.svg?logo=python&logoColor=white\n :target: https://pypi.org/project/lightgbm\n.. |PyPI Version| image:: https://img.shields.io/pypi/v/lightgbm.svg?logo=pypi&logoColor=white\n :target: https://pypi.org/project/lightgbm\n.. |Downloads| image:: https://pepy.tech/badge/lightgbm\n :target: https://pepy.tech/project/lightgbm\n.. |API Docs| image:: https://readthedocs.org/projects/lightgbm/badge/?version=latest\n :target: https://lightgbm.readthedocs.io/en/latest/Python-API.html\n.. _CMake: https://cmake.org/\n",
"bugtrack_url": null,
"license": "The MIT License (MIT) Copyright (c) Microsoft Corporation Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "LightGBM Python Package",
"version": "4.3.0",
"project_urls": {
"Changelog": "https://github.com/microsoft/LightGBM/releases",
"Documentation": "https://lightgbm.readthedocs.io/en/latest/",
"Homepage": "https://github.com/microsoft/LightGBM",
"Repository": "https://github.com/microsoft/LightGBM.git"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e3a93bfb8f52fee7ab0950bb94920776dbca00b9515ff5fa504374c059d6192c",
"md5": "f0b1533e17a2942e879cddf34f740c37",
"sha256": "7e7c84e30607d043cc07ab7c0ffe3109120bde8e7e126f6a6151ca010c40fe3f"
},
"downloads": -1,
"filename": "lightgbm-4.3.0-py3-none-macosx_10_15_x86_64.macosx_11_6_x86_64.macosx_12_5_x86_64.whl",
"has_sig": false,
"md5_digest": "f0b1533e17a2942e879cddf34f740c37",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 1779026,
"upload_time": "2024-01-26T03:29:02",
"upload_time_iso_8601": "2024-01-26T03:29:02.181976Z",
"url": "https://files.pythonhosted.org/packages/e3/a9/3bfb8f52fee7ab0950bb94920776dbca00b9515ff5fa504374c059d6192c/lightgbm-4.3.0-py3-none-macosx_10_15_x86_64.macosx_11_6_x86_64.macosx_12_5_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "310c396ef267e1d79879c85b33d039c07e4f66d5d319781c79ec1f79cc216460",
"md5": "1140f69dc4180d1a3c690c2b2eb3afb3",
"sha256": "25eb3dd661d75ccf8a46de686b07def3a2e06eacab7da5937d82543732183688"
},
"downloads": -1,
"filename": "lightgbm-4.3.0-py3-none-manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "1140f69dc4180d1a3c690c2b2eb3afb3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 3080041,
"upload_time": "2024-01-26T03:29:05",
"upload_time_iso_8601": "2024-01-26T03:29:05.941258Z",
"url": "https://files.pythonhosted.org/packages/31/0c/396ef267e1d79879c85b33d039c07e4f66d5d319781c79ec1f79cc216460/lightgbm-4.3.0-py3-none-manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ba11cb8b67f3cbdca05b59a032bb57963d4fe8c8d18c3870f30bed005b7f174d",
"md5": "c16db1e9036f3a83c57be46f4e12c81b",
"sha256": "104496a3404cb2452d3412cbddcfbfadbef9c372ea91e3a9b8794bcc5183bf07"
},
"downloads": -1,
"filename": "lightgbm-4.3.0-py3-none-manylinux_2_28_x86_64.whl",
"has_sig": false,
"md5_digest": "c16db1e9036f3a83c57be46f4e12c81b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 3107381,
"upload_time": "2024-01-26T03:29:08",
"upload_time_iso_8601": "2024-01-26T03:29:08.323784Z",
"url": "https://files.pythonhosted.org/packages/ba/11/cb8b67f3cbdca05b59a032bb57963d4fe8c8d18c3870f30bed005b7f174d/lightgbm-4.3.0-py3-none-manylinux_2_28_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e14c4685ccfae9806f561de716e32549190c1f533dde5bcadaf83bdf23972cf0",
"md5": "78f1a9a3b3541d79b63cd57914cfdf59",
"sha256": "89bc9ef2b97552bfa07523416513d27cf3344bedf9bcb1f286e636ebe169ed51"
},
"downloads": -1,
"filename": "lightgbm-4.3.0-py3-none-win_amd64.whl",
"has_sig": false,
"md5_digest": "78f1a9a3b3541d79b63cd57914cfdf59",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 1337902,
"upload_time": "2024-01-26T03:29:10",
"upload_time_iso_8601": "2024-01-26T03:29:10.859463Z",
"url": "https://files.pythonhosted.org/packages/e1/4c/4685ccfae9806f561de716e32549190c1f533dde5bcadaf83bdf23972cf0/lightgbm-4.3.0-py3-none-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "74d12e4b02e4611ab36647639c4eea8c4520bb90f948563e00a3bec583a9f9f5",
"md5": "0b7e928d05de3d7417c8c7a644d4ceda",
"sha256": "006f5784a9bcee43e5a7e943dc4f02de1ba2ee7a7af1ee5f190d383f3b6c9ebe"
},
"downloads": -1,
"filename": "lightgbm-4.3.0.tar.gz",
"has_sig": false,
"md5_digest": "0b7e928d05de3d7417c8c7a644d4ceda",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 1694675,
"upload_time": "2024-01-26T03:29:13",
"upload_time_iso_8601": "2024-01-26T03:29:13.020885Z",
"url": "https://files.pythonhosted.org/packages/74/d1/2e4b02e4611ab36647639c4eea8c4520bb90f948563e00a3bec583a9f9f5/lightgbm-4.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-26 03:29:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "microsoft",
"github_project": "LightGBM",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"appveyor": true,
"lcname": "lightgbm"
}
