A common source of pain a grief for Numba users are issues related to pip install llvmlite
. For example recently: pip3 install llvmlite fails · Issue #697 · numba/llvmlite · GitHub
The issue is almost always that users end up seeing the line:
FileNotFoundError: [Errno 2] No such file or directory: 'llvm-config'
And, as expressed in pip3 install llvmlite fails · Issue #697 · numba/llvmlite · GitHub searching for this stack trace on the internet yields many issues with attempted solution ideas across a broad range of suggestions. The main problem here, is that multiple error conditions yield this error message and there is no universal solution.
However, the current situation is a pain for users and developers so I propose an approach to mitigate this.
a) If llvm-config
can not be found, mention this to the user and point them at the llvmlite FAQ, rather than echoing the full stack trace. Users should not google the original error message any more, it is too deep a rabbit hole.
b) Than, add something along the lines of the following to the FAQ:
Q: What can I do about llvm-config
not being found?
A: This depends on your original intent:
I am a user and I wanted to pip install llvmlite
/ pip install numba
and I expected to install binary/pre-compiled wheels.
- Check that your Python version is supported by llvmlite/numba
- Check if you architecture is supported by our binary wheels: Linux (x86(32bit) / x86_64(64bit) OSX (x86_64) Win(x86(32bit) / x86_64(64bit)) – currently no Aarch64 Wheel support, so no RaspberryPi.
- On Linux: check your
pip
version, at least19.0
is needed to install manylinux2010 wheels. - Still having issues: try conda, compile from source or ask on Discourse /Gitter
I am a developer and I wanted to compile llvmlite from source.
- Make sure that
llvm-config
is on the$PATH
and executable - Ask on Discourse / Gitter