This is a guide on how to install ASReview for MacOS (and Linux).
Check if Python is installed
This section explains how to install Python on your computer. The ASReview software runs with Python in the background. MacOS comes with Python version 2.7 already installed. However, ASReview requires Python 3.6 or higher and therefore, a more recent version of Python should be installed. More knowledge about Python is not necessary to run ASReview.
First, check which version of Python is currently installed on your computer. Open your Launchpad (in your Dock) and search for the program Terminal. Open the Terminal.
Within the terminal, execute the following:
Now, if the command returns you have a Python version is 3.6 or higher, you can go to the section Install ASReview.
However, if the command returns a Python version lower than 3.6, or a message like
'python' is not recognized as an internal or external command, operable program or batch file, you will still have to install Python.
To install Python, we recommend to install Miniconda. Miniconda offers a user-friendly Python environment. Download the ‘Miniconda3 MacOSX 64-bit pkg’ from the Miniconda website and follow the default installation instructions.
After installing Python, make sure to close and reopen program Terminal and again execute
If your Python version is 3.6 or higher, you can start installing the ASReview on your computer. Execute the following in the Command prompt (
pip install asreview
If ASReview was successfully installed this command should return a bunch of text of which the last line is something like:
Successfully installed asreview-0.14
Note: if you run into an error at this step, try executing
python -m pip install asreview instead. If this doesn’t fix your problems, please consult the Troubleshooting section of our documentation `.
If you want to use our COVID-19 plugin, you can install it at this step by executing:
pip install asreview-covid19
The plugin will be available automatically upon launching ASReview.
You are now ready to start using ASReview. Launch ASReview by executing in the Command prompt (
Be aware the software requires the data to be in a specific format, so be prepared!