Installation Troubleshooting#

Cannot install PyQt6 dependency#

Idtrackerai’s GUIs use PyQt6 by default. But if its installation fails, giving some of the next errors:

  • sipbuild.exceptions.UserException

  • error: metadata-generation-failed

  • sipbuild.pyproject.PyProjectOptionException

  • Frozen process while Preparing metadata (pyproject.toml)... (especially on MacOS)

you can choose to install any of the remaining Qt bindings for Python (you only need one of them to succeed):

Note

If any Qt installation works on your computer, you can still use the non-GUI parts of idtrackerai by following these commands without any Qt installation.

Qt binding options in Python#
python -m pip install PyQt6 # default
python -m pip install PyQt5
python -m pip install PySide6
python -m pip install PySide2

Once any of these installations succeed, you will need to install idtrackerai without the PyQt6 dependency:

# install idtrackerai without any dependency
python -m pip install idtrackerai --no-deps

# install all remaining dependencies except PyQt6
python -m pip install numpy rich h5py scipy opencv-python-headless qtpy superqt toml matplotlib packaging psutil scikit-learn

Not recognized command#

If you have just installed idtracker.ai and encounter a short error like No such file or directory or Not recognized command when running idtrackerai_test, try reactivating the Conda environment:

conda deactivate
conda activate idtrackerai

Could not load library libcudnn_cnn_infer.so.8#

If idtrackerai_test starts but after a few seconds you see an error like Could not load library libcudnn_cnn_infer.so.8, it means you are missing the Cuda Toolkit dependency. Install it with:

conda install cudatoolkit=11.8 -c conda-forge

qt.qpa.plugin: Could not load the Qt platform plugin “xcb”#

Refer to this thread for more information. Alternatively, on Ubuntu, you can solve the problem by running sudo apt install libxcb-cursor0.

module ‘torch’ has no attribute ‘_six’#

In MacOS, running

python -m pip install --upgrade torch

seems to fix the issue.

ImportError: cannot import name COMMON_SAFE_ASCII_CHARACTERS from charset_normalizer.constant#

From Stack Overflow:

python -m pip install chardet

No graphic device was found available#

If your computer has an NVIDIA or AMD GPU, or uses MacOS >= 12.3 with an M1, M2, or AMD GPU, and idtrackerai cannot find the specific device available, it means your PyTorch installation is malfunctioning.

To fix this, you need to Uninstall the entire Conda environment and try again. Carefully read the PyTorch instructions based on your machine. Getting PyTorch to use GPU acceleration can sometimes be tricky.

Any other error

Send us your error to info@idtracker.ai and we will assist you.