MacOS wheel compatibility issues

Mac OS users may notice that pip does not find compatible binary wheels, or refuses to install wheels downloaded from Github.

This is because the system python, and python installed via conda default channels, installs a backwards compatible Python, which does not support newer OS tags. You can find compatible tags with

pip debug --verbose | more

There's a few options for dealing with this. One is to install a more modern python with conda-forge:

conda create -n <name> python=3.11 -c conda-forge

Another option is to use the environment variable SYSTEM_VERSION_COMPAT to disable compatibility checking:

SYSTEM_VERSION_COMPAT=0 pip install antspyx-0.5.3-cp311-cp311-macosx_12_0_x86_64.whl

Alternatively, if installation time is not an issue, one can simply let pip build the wheel from source.