PyQt5 installation problems
If you have trouble installing neoscore, first try installing PyQt5 alone with
pip install PyQt5. If this fails too, follow these troubleshooting steps.
First try upgrading pip with
pip install --upgrade pip; this should fix many errors.
If that doesn’t help and you’re on a Mac system using an M1 chip, try running within the M1 compatibility layer Rosetta as described here.
If none of these steps help, check your python version with
python --version. If you aren’t running on 3.7, try switching your environment’s version to 3.7 (we recommend using pyenv if you don’t know how to do this) and repeat the above steps.
Pillow installation problems
Some versions of Mac OS have trouble installing one of our dependencies, Pillow. If your installation fails, try running these commands in your environment:
pip uninstall Pillow pip install --upgrade Pillow --no-binary :all:
Other Python Errors
If you’re getting errors saying neoscore isn’t installed or other strange Python errors, confirm that you are running on Python version 3.7 or higher with
python --version. If you don’t have it, you’ll need to install it. We strongly recommend using a dedicated virtual environment for each of your projects using neoscore.
We track bugs and known feature gaps at our issue tracker. If you think you’ve encountered a bug, please let us know by opening an issue! But please be sure to check for neoscore updates first (
pip install --upgrade neoscore) in case we’ve already fixed it, and otherwise try to find if the bug has already been reported.
Please also consider opening an issue or posting in our forum if any part of these docs were confusing or difficult for you. If you’ve found a typo in these docs please feel free to directly open a pull request to fix it!