Check if Python is installed

This section explains how to install Python on your computer. The ASReview software runs with Python in the background. Therefore, running ASReview requires having Python 3.6+ installed. Knowledge about Python is not necessary to run ASReview. To start ASReview you have to open the Command Line Interface (CLI). The CLI allows you to interact with your computer directly and is operated by text inputs (commands), rather than through a graphical interface with clickable buttons. If this is the first time you’re working in the CLI, don’t worry, as this tutorial will guide you through all the steps.

Several users encounter issues with installing ASReview since a recent upgrade of Windows due to an issue with the numpy dependency. Windows recently released a new version which, unfortunately, breaks all kinds of packages, including numpy. Numpy is a library for Python used by thousands of software packages including ASReview. If you recently upgraded windows you might encounter an error about numpy when installing ASReview. If so, you can find a solution on our Github page. Please let us know (via Github) if it solved your issue or if you found a different solution – MANY THANKS!

 

Step 1: open Command Prompt

To open the Command Prompt, open the search field of Windows and enter CMD. Click on Command Prompt.

Step 2: check if python is installed

Write python --version and press enter.

 

The command should return a message you have a Python version 3.6 or higher. If so, proceed with Step 4.

If the Python version is different or if the command returns 'python' is not recognized as an internal or external command, operable program or batch file, you will have to install Python, proceed with Step 3.

 

Install Python

IMPORTANT: during the installation process make sure to check the box to add Python to your PATH environment variable:

Step 3: Install Python

  1. Go to python.org/downloads to download Python version for Windows and follow the default installation instructions.
  2. After installing Python, close and reopen your Command prompt (CMD.exe), and again execute python --version.

 

Install ASReview

Step 4: install ASReview

  1. Type pip install asreview in the Command Prompt and press ENTER.
  2. After installation, you will see Successfully installed asreview-0.17

If you want to use our COVID-19 plugin with thousands of Corona related papers (CORD19 database + pre-print database), you can install it by executing:

pip install asreview-covid19

The plugin will be available automatically upon launching ASReview.

Problem? Please consult the Troubleshooting section of the ASReview documentation.

Launch ASReview

Step 5: Open ASReview

Type asreview lab in the Command prompt and press ENTER.

 

Congratulations!

You are now ready to start using ASReview. Proceed with initializing your first project, uploading your data and then you can start with your first AI-aided systematic review – ENJOY!!

 

Be aware the software requires the data to be in a specific format, so be prepared!

 

More info

If you want to know more about the available features, if you have questions, or if you want to know more about the technical specifications, go to our documentation.