interpretableai package is a wrapper around the Julia implementation of IAI algorithms, so you need to configure a working Julia installation in addition to installing the Python package from PyPI.
Follow the instructions for installing the IAI system image to get a working Julia installation with the IAI modules included.
In order to use Julia to run the IAI algorithms, Python also needs to know where to find Julia on your computer. By default, it will look for an executable on the system
julia. It is also possible to specify the location of Julia manually if preferred.
You can install the Python package with
$ pip install interpretableai
Once installed, you need to run the following command in Python to configure the connection to Julia for access the IAI algorithms. This only needs to be run the first time following installation of the
import interpretableai interpretableai.install()
Following this one-time installation, you can now use the IAI algorithms in any Python session by loading the package with the following command:
from interpretableai import iai
After this, all of the package functionality is available under the
Below is a list of errors you might receive when setting up the package and how to resolve them. If none of the suggestions fix the problem, you can also refer to the PyJulia troubleshooting guide.
interpretableai.install(), you may receive the following error if Julia is not correctly configured:
julia.core.JuliaNotFound: Julia executable `julia` cannot be found. If you have installed Julia, make sure Julia executable is in the system PATH. Alternatively, specify file path to the Julia executable using `julia` keyword argument. If you have not installed Julia, download Julia from https://julialang.org/downloads/ and install it.
from interpretableai import iai, you may receive the following error if Julia is not correctly configured:
FileNotFoundError: [Errno 2] No such file or directory: 'julia': 'julia'
On Windows only, you may also see a message similar to the following about being unable to load a library:
WARNING: Error during initialization of module PCRE: ErrorException("could not load library "libpcre2-8" The specified module could not be found. ")
In each case, you will either need to add
julia to the system
PATH, or follow the steps to specify the path to Julia.
For certain Python distributions (e.g Anaconda, Ubuntu), you may see the following error when initializing Julia:
RuntimeError: It seems your Julia and PyJulia setup are not supported. Julia executable: julia Python interpreter and libpython used by PyCall.jl: /usr/bin/python3 /usr/lib/x86_64-linux-gnu/libpython3.6m.so.1.0 Python interpreter used to import PyJulia and its libpython. /usr/bin/python3 /usr/lib/x86_64-linux-gnu/libpython3.6m.so.1.0 Your Python interpreter "/usr/bin/python3" is statically linked to libpython. Currently, PyJulia does not fully support such Python interpreter. The easiest workaround is to pass `compiled_modules=False` to `Julia` constructor. To do so, first *reboot* your Python REPL (if this happened inside an interactive session) and then evaluate: >>> from julia.api import Julia >>> jl = Julia(compiled_modules=False) Another workaround is to run your Python script with `python-jl` command bundled in PyJulia. You can simply do: $ python-jl PATH/TO/YOUR/SCRIPT.py See `python-jl --help` for more information. For more information, see: https://pyjulia.readthedocs.io/en/latest/troubleshooting.html
There are two options to resolve this error:
Set the enviroment variable
Manually initialize the connection to Julia and pass
from julia import Julia Julia(compiled_modules=False) from interpretableai import iai
This initialization step will need to be done in every Python session.
julia is not on the system
PATH, or you would like to use another Julia executable, there are two additional ways to specify the location of Julia.
If you are unsure of the path to your Julia installation, you can get the path to the
julia executable by running the following command in Julia:
You can set the environment variable
IAI_JULIA to point to the
julia executable. You can then proceed with installing and importing the package as usual.
Specifying the location of Julia manually does not work on Windows. You must either add Julia to the
PATH or set
IAI_JULIA to point to your Julia installation.
If you would like to specify the location of Julia without using environment variables, you can pass the path to a Julia executable to
import interpretableai interpretableai.install(runtime='path/to/julia')
You will also need to take an additional step in order to manually initialize the connection to Julia with the path to
julia as the
runtime argument. This will need to be done in every Python session before importing
from julia import Julia Julia(runtime='path/to/julia') # and any other parameters as needed from interpretableai import iai
If you do not replace the default Julia system image, there are two additional ways to specify the location of the system image.
You can set the environment variable
IAI_SYSTEM_IMAGE to point to the location of the system image. You can then proceed with installing and importing the package as usual.
If you would like to specify the location of the system image without using environment variables, you will need to manually initialize the connection to Julia with the path to the system image as the
sysimage argument. This will need to be done in every Python session before importing the
from julia import Julia Julia(sysimage='path/to/sys') # and any other parameters as needed from interpretableai import iai
Development builds of the
interpretableai package are uploaded to the Test PyPI repository, and can be installed with the following command:
$ pip install --extra-index-url https://test.pypi.org/simple/ interpretableai
There is no need to use these development builds unless directed to do so.