Fail to install bertopic

[zhimin-z]

it throws the following error message:

(.venv) PS C:\Users\zhimi\OneDrive\Documents\GitHub\Evalware-Survey> pip install bertopic
Collecting bertopic
  Downloading bertopic-0.17.3-py3-none-any.whl.metadata (24 kB)
Collecting hdbscan>=0.8.29 (from bertopic)
  Downloading hdbscan-0.8.40.tar.gz (6.9 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 6.9/6.9 MB 6.3 MB/s eta 0:00:00
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
Requirement already satisfied: umap-learn>=0.5.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from bertopic) (0.5.9.post2)
Requirement already satisfied: numpy>=1.20.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from bertopic) (2.1.3)
Requirement already satisfied: pandas>=1.1.5 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from bertopic) (2.2.3)
Requirement already satisfied: plotly>=4.7.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from bertopic) (6.1.2)
Requirement already satisfied: scikit-learn>=1.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from bertopic) (1.7.0)
Requirement already satisfied: sentence-transformers>=0.4.1 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from bertopic) (5.0.0)
Requirement already satisfied: tqdm>=4.41.1 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from bertopic) (4.67.1)
Requirement already satisfied: llvmlite>0.36.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from bertopic) (0.44.0)
Requirement already satisfied: scipy>=1.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from hdbscan>=0.8.29->bertopic) (1.15.3)
Requirement already satisfied: joblib>=1.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from hdbscan>=0.8.29->bertopic) (1.5.1)
Requirement already satisfied: python-dateutil>=2.8.2 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from pandas>=1.1.5->bertopic) (2.9.0.post0)       
Requirement already satisfied: pytz>=2020.1 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from pandas>=1.1.5->bertopic) (2025.1)
Requirement already satisfied: tzdata>=2022.7 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from pandas>=1.1.5->bertopic) (2025.1)
Requirement already satisfied: narwhals>=1.15.1 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from plotly>=4.7.0->bertopic) (1.42.0)
Requirement already satisfied: packaging in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from plotly>=4.7.0->bertopic) (24.2)
Requirement already satisfied: threadpoolctl>=3.1.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from scikit-learn>=1.0->bertopic) (3.6.0)
Requirement already satisfied: transformers<5.0.0,>=4.41.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from sentence-transformers>=0.4.1->bertopic) (4.53.2)
Requirement already satisfied: torch>=1.11.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from sentence-transformers>=0.4.1->bertopic) (2.7.1)       
Requirement already satisfied: huggingface-hub>=0.20.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from sentence-transformers>=0.4.1->bertopic) (0.32.3)
Requirement already satisfied: Pillow in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from sentence-transformers>=0.4.1->bertopic) (11.3.0)
Requirement already satisfied: typing_extensions>=4.5.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from sentence-transformers>=0.4.1->bertopic) (4.12.2)
Requirement already satisfied: colorama in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from tqdm>=4.41.1->bertopic) (0.4.6)
Requirement already satisfied: numba>=0.51.2 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from umap-learn>=0.5.0->bertopic) (0.61.0)
Requirement already satisfied: pynndescent>=0.5 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from umap-learn>=0.5.0->bertopic) (0.5.13)
Requirement already satisfied: filelock in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from huggingface-hub>=0.20.0->sentence-transformers>=0.4.1->bertopic) (3.18.0)
Requirement already satisfied: fsspec>=2023.5.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from huggingface-hub>=0.20.0->sentence-transformers>=0.4.1->bertopic) (2025.3.0)
Requirement already satisfied: pyyaml>=5.1 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from huggingface-hub>=0.20.0->sentence-transformers>=0.4.1->bertopic) (6.0.2)
Requirement already satisfied: requests in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from huggingface-hub>=0.20.0->sentence-transformers>=0.4.1->bertopic) (2.32.3)
Requirement already satisfied: six>=1.5 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from python-dateutil>=2.8.2->pandas>=1.1.5->bertopic) (1.17.0)
Requirement already satisfied: sympy>=1.13.3 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from torch>=1.11.0->sentence-transformers>=0.4.1->bertopic) (1.14.0)
Requirement already satisfied: networkx in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from torch>=1.11.0->sentence-transformers>=0.4.1->bertopic) (3.5)
Requirement already satisfied: jinja2 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from torch>=1.11.0->sentence-transformers>=0.4.1->bertopic) (3.1.6)
Requirement already satisfied: setuptools in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from torch>=1.11.0->sentence-transformers>=0.4.1->bertopic) (80.9.0)
Requirement already satisfied: regex!=2019.12.17 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from transformers<5.0.0,>=4.41.0->sentence-transformers>=0.4.1->bertopic) (2024.11.6)
Requirement already satisfied: tokenizers<0.22,>=0.21 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from transformers<5.0.0,>=4.41.0->sentence-transformers>=0.4.1->bertopic) (0.21.2)
Requirement already satisfied: safetensors>=0.4.3 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from transformers<5.0.0,>=4.41.0->sentence-transformers>=0.4.1->bertopic) (0.5.3)
Requirement already satisfied: mpmath<1.4,>=1.1.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from sympy>=1.13.3->torch>=1.11.0->sentence-transformers>=0.4.1->bertopic) (1.3.0)
Requirement already satisfied: MarkupSafe>=2.0 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from jinja2->torch>=1.11.0->sentence-transformers>=0.4.1->bertopic) (3.0.2)
Requirement already satisfied: charset-normalizer<4,>=2 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from requests->huggingface-hub>=0.20.0->sentence-transformers>=0.4.1->bertopic) (3.4.1)
Requirement already satisfied: idna<4,>=2.5 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from requests->huggingface-hub>=0.20.0->sentence-transformers>=0.4.1->bertopic) (3.10)
Requirement already satisfied: urllib3<3,>=1.21.1 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from requests->huggingface-hub>=0.20.0->sentence-transformers>=0.4.1->bertopic) (2.3.0)
Requirement already satisfied: certifi>=2017.4.17 in c:\users\zhimi\onedrive\documents\github\evalware-survey\.venv\lib\site-packages (from requests->huggingface-hub>=0.20.0->sentence-transformers>=0.4.1->bertopic) (2025.1.31)
Downloading bertopic-0.17.3-py3-none-any.whl (153 kB)
Building wheels for collected packages: hdbscan
  Building wheel for hdbscan (pyproject.toml) ... error
  error: subprocess-exited-with-error

  × Building wheel for hdbscan (pyproject.toml) did not run successfully.
  │ exit code: 1
  ╰─> [39 lines of output]
      C:\Users\zhimi\AppData\Local\Temp\pip-build-env-ziv51p0u\overlay\Lib\site-packages\setuptools\_distutils\dist.py:289: UserWarning: Unknown distribution option: 'test_suite'
        warnings.warn(msg)
      C:\Users\zhimi\AppData\Local\Temp\pip-build-env-ziv51p0u\overlay\Lib\site-packages\setuptools\_distutils\dist.py:289: UserWarning: Unknown distribution option: 'tests_require'        
        warnings.warn(msg)
      C:\Users\zhimi\AppData\Local\Temp\pip-build-env-ziv51p0u\overlay\Lib\site-packages\setuptools\dist.py:759: SetuptoolsDeprecationWarning: License classifiers are deprecated.
      !!

              ********************************************************************************
              Please consider removing the following classifiers in favor of a SPDX license expression:

              License :: OSI Approved

              See https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#license for details.
              ********************************************************************************

      !!
        self._finalize_license_expression()
      running bdist_wheel
      running build
      running build_py
      creating build\lib.win-amd64-cpython-313\hdbscan
      copying hdbscan\branches.py -> build\lib.win-amd64-cpython-313\hdbscan
      copying hdbscan\flat.py -> build\lib.win-amd64-cpython-313\hdbscan
      copying hdbscan\hdbscan_.py -> build\lib.win-amd64-cpython-313\hdbscan
      copying hdbscan\plots.py -> build\lib.win-amd64-cpython-313\hdbscan
      copying hdbscan\prediction.py -> build\lib.win-amd64-cpython-313\hdbscan
      copying hdbscan\robust_single_linkage_.py -> build\lib.win-amd64-cpython-313\hdbscan
      copying hdbscan\validity.py -> build\lib.win-amd64-cpython-313\hdbscan
      copying hdbscan\__init__.py -> build\lib.win-amd64-cpython-313\hdbscan
      creating build\lib.win-amd64-cpython-313\hdbscan\tests
      copying hdbscan\tests\test_branches.py -> build\lib.win-amd64-cpython-313\hdbscan\tests
      copying hdbscan\tests\test_flat.py -> build\lib.win-amd64-cpython-313\hdbscan\tests
      copying hdbscan\tests\test_hdbscan.py -> build\lib.win-amd64-cpython-313\hdbscan\tests
      copying hdbscan\tests\test_prediction_utils.py -> build\lib.win-amd64-cpython-313\hdbscan\tests
      copying hdbscan\tests\test_rsl.py -> build\lib.win-amd64-cpython-313\hdbscan\tests
      copying hdbscan\tests\__init__.py -> build\lib.win-amd64-cpython-313\hdbscan\tests
      running build_ext
      building 'hdbscan._hdbscan_tree' extension
      error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
  ERROR: Failed building wheel for hdbscan
Failed to build hdbscan

[notice] A new release of pip is available: 25.0.1 -> 25.1.1
[notice] To update, run: python.exe -m pip install --upgrade pip
ERROR: Failed to build installable wheels for some pyproject.toml based projects (hdbscan)

My envirvonment: Python 3.13.4, Windows 11

[MaartenGr]

I would advise checking existing issues. There are a couple of them explaining what to do in this particular scenario. Also note that the solution is presented in your stack trace, namely:

error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/