[Docs] Some additional infos might be necessary in the mmpose instalation process.

[ANaaim]

📚 The doc issue

Trying to install mmpose, following the recommendation on : https://mmpose.readthedocs.io/en/latest/installation.html did not work directly. I had to find that a specific version of pytorch should be installed (1.13) when by default the 2.X is installed making the following part of the installation impossible. (By default the cpu version that was installed)

The final process I had to use :

Create a base environment

conda create --name openmmlab python=3.8 -y
conda activate openmmlab

Install correct version of pytorch

conda install pytorch==1.13.1 torchvision==0.14.1 torchaudio==0.13.1 pytorch-cuda=11.6 -c pytorch -c nvidia

To found the last prompt I had to go to this doc : https://mmcv.readthedocs.io/en/latest/get_started/installation.html

Then follow the default instalation .

pip install -U openmim
mim install mmengine
mim install "mmcv>=2.0.1"
mim install "mmdet>=3.1.0"

mim install "mmpose>=1.1.0"
mim install "mmpretrain>=1.0.0rc8"

Suggest a potential alternative/fix

Maybe add to the guide that a specific version of pytorch might be needed and a link to the page with the supported version supported (link to https://mmcv.readthedocs.io/en/latest/get_started/installation.html where it is well described).

But I might, i have done the base instalation badly.

[ANaaim]

Problem might be similar to #3035 in the end.

[zhouzaida]

mmcv has provided pre-compiled packages for PyTorch 2.1, and theoretically, the installation should not be an issue? Could you provide some error messages so that we can analyze and locate the problem?

[ANaaim]

code used :

conda create --name  demo_install_openmmlab python=3.8 -y
conda activate demo_install_openmmlab

conda install pytorch torchvision -c pytorch

pip install -U openmim
mim install mmengine
mim install "mmcv>=2.0.1"

Till mim install mmcv everything seems to go smmothly but from there it stay blocked and it try to install a cpu version as I understand it ( ....download.openmmlab.com/mmcv/dist/cpu/torch2.2.0/index.html).

Looking in links: https://download.openmmlab.com/mmcv/dist/cpu/torch2.2.0/index.html
Collecting mmcv>=2.0.1
  Using cached mmcv-2.1.0.tar.gz (471 kB)
  Preparing metadata (setup.py) ... done
Requirement already satisfied: addict in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmcv>=2.0.1) (2.4.0)
Requirement already satisfied: mmengine>=0.3.0 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmcv>=2.0.1) (0.10.3)
Requirement already satisfied: numpy in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmcv>=2.0.1) (1.24.3)
Requirement already satisfied: packaging in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmcv>=2.0.1) (24.0)
Requirement already satisfied: Pillow in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmcv>=2.0.1) (10.2.0)
Requirement already satisfied: pyyaml in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmcv>=2.0.1) (6.0.1)
Requirement already satisfied: yapf in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmcv>=2.0.1) (0.40.2)
Requirement already satisfied: regex in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmcv>=2.0.1) (2024.4.16)
Requirement already satisfied: matplotlib in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmengine>=0.3.0->mmcv>=2.0.1) (3.7.5)
Requirement already satisfied: rich in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmengine>=0.3.0->mmcv>=2.0.1) (13.4.2)
Requirement already satisfied: termcolor in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmengine>=0.3.0->mmcv>=2.0.1) (2.4.0)
Requirement already satisfied: opencv-python>=3 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from mmengine>=0.3.0->mmcv>=2.0.1) (4.9.0.80)
Requirement already satisfied: importlib-metadata>=6.6.0 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from yapf->mmcv>=2.0.1) (7.1.0)
Requirement already satisfied: platformdirs>=3.5.1 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from yapf->mmcv>=2.0.1) (4.2.0)
Requirement already satisfied: tomli>=2.0.1 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from yapf->mmcv>=2.0.1) (2.0.1)
Requirement already satisfied: zipp>=0.5 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from importlib-metadata>=6.6.0->yapf->mmcv>=2.0.1) (3.18.1)
Requirement already satisfied: contourpy>=1.0.1 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from matplotlib->mmengine>=0.3.0->mmcv>=2.0.1) (1.1.1)
Requirement already satisfied: cycler>=0.10 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from matplotlib->mmengine>=0.3.0->mmcv>=2.0.1) (0.12.1)
Requirement already satisfied: fonttools>=4.22.0 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from matplotlib->mmengine>=0.3.0->mmcv>=2.0.1) (4.51.0)
Requirement already satisfied: kiwisolver>=1.0.1 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from matplotlib->mmengine>=0.3.0->mmcv>=2.0.1) (1.4.5)
Requirement already satisfied: pyparsing>=2.3.1 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from matplotlib->mmengine>=0.3.0->mmcv>=2.0.1) (3.1.2)
Requirement already satisfied: python-dateutil>=2.7 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from matplotlib->mmengine>=0.3.0->mmcv>=2.0.1) (2.9.0.post0)
Requirement already satisfied: importlib-resources>=3.2.0 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from matplotlib->mmengine>=0.3.0->mmcv>=2.0.1) (6.4.0)
Requirement already satisfied: markdown-it-py>=2.2.0 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from rich->mmengine>=0.3.0->mmcv>=2.0.1) (3.0.0)
Requirement already satisfied: pygments<3.0.0,>=2.13.0 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from rich->mmengine>=0.3.0->mmcv>=2.0.1) (2.17.2)
Requirement already satisfied: typing-extensions<5.0,>=4.0.0 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from rich->mmengine>=0.3.0->mmcv>=2.0.1) (4.9.0)
Requirement already satisfied: mdurl~=0.1 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from markdown-it-py>=2.2.0->rich->mmengine>=0.3.0->mmcv>=2.0.1) (0.1.2)
Requirement already satisfied: six>=1.5 in c:\users\naaim\miniconda3\envs\demo_install_openmmlab\lib\site-packages (from python-dateutil>=2.7->matplotlib->mmengine>=0.3.0->mmcv>=2.0.1) (1.16.0)
Building wheels for collected packages: mmcv
  Building wheel for mmcv (setup.py) ... -

And from there it stay ''frozen'' but as I understand it it try to build a adapted wheel for my computer and it is a LONG process.

Hope that it helps. If you need any additional information let me know.

[ANaaim]

Small question is there any pre compiled package for Pytorch 2.2 ? If yes, by default currerntly it seems that it is the pytorch 2.2 that is installed when using the default command :

conda install pytorch torchvision -c pytorch