---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.3
alternate:
  - https://catboost.ai/docs/en/installation/python-installation-method-conda-install.md
---
> **Documentation Index:** Fetch the complete configuration index at https://catboost.ai/docs/en/llms.txt

# conda install

<!-- source: en/_includes/work_src/reusage-installation/python__supported-versions.md -->
{% note info %}

CatBoost Python package supports only [CPython Python implementation](https://en.wikipedia.org/wiki/CPython).

{% endnote %}
<!-- endsource: en/_includes/work_src/reusage-installation/python__supported-versions.md -->

{% note info %}

All Conda packages for Windows have CUDA support.
Conda packages for Linux contain variants with or without CUDA support.

All necessary CUDA libraries are statically linked in the released Linux and Windows binaries, the only installation necessary is the appropriate version of the CUDA driver.

{% endnote %}

<!-- source: en/_includes/work_src/reusage-common-phrases/install-from-conda-forge-channel.md -->
To install CatBoost from the conda-forge channel:
<!-- endsource: en/_includes/work_src/reusage-common-phrases/install-from-conda-forge-channel.md -->


1. Add conda-forge to your channels:
    ```no-highlight
    conda config --add channels conda-forge
    ```

1. Install CatBoost:
    ```no-highlight
    conda install catboost
    ```

1. Install visualization tools:
    1. <!-- source: en/_includes/work_src/reusage-installation/install-apywidgets-short.md -->
       Install the `ipywidgets` Python package (version 7.x or higher is required):
       <!-- endsource: en/_includes/work_src/reusage-installation/install-apywidgets-short.md -->

    ```no-highlight
    conda install ipywidgets
    ```

    1. <!-- source: en/_includes/work_src/reusage-installation/turn-on-the-widgets-extension-intro.md -->
       Turn on the widgets extension:
       <!-- endsource: en/_includes/work_src/reusage-installation/turn-on-the-widgets-extension-intro.md -->

    ```no-highlight
    jupyter nbextension enable --py widgetsnbextension
    ```

    Refer to the following sections for details:
    - [Data visualization](https://catboost.ai/docs/en/features/visualization.md)
    - [Additional packages for data visualization support](https://catboost.ai/docs/en/installation/python-installation-additional-data-visualization-packages.md)

1. User-defined functions:

    <!-- source: en/_includes/work_src/reusage-installation/python__user-defined-functions-dependencies.md -->
    If you want to use [custom metrics or objectives implemented in your own python code](https://catboost.ai/docs/en/features/custom-loss-functions.md) you should install [`numba`](https://numba.pydata.org/) package to speed up the code execution using JIT compilation.

    If you want to use custom metrics or objectives on GPUs with CUDA support you must install [`numba`](https://numba.pydata.org/) package for JIT compilation of CUDA code.
    Installation of [`numba-cuda`](https://github.com/NVIDIA/numba-cuda) package is also encouraged.
    CUDA itself (not only drivers) must be installed on machines where this code is executed.
    See [`numba` CUDA support documentation](https://numba.readthedocs.io/en/stable/cuda/overview.html) for more details.

    These packages are not listed in package requirements that are installed automatically because they are not needed for other functionality.
    <!-- endsource: en/_includes/work_src/reusage-installation/python__user-defined-functions-dependencies.md -->