Installation

Install ASReview

ASReview software requires an installation of Python 3.7 or later. Detailed step-by-step instructions to install Python (and ASReview) are available for Windows and macOS/Linux users.

Install the ASReview software with Pip by running the following command in the CMD.exe (Windows) or Terminal (MacOS/Linux):

pip install asreview

Start the application with the following command (in CMD.exe or Terminal):

asreview lab

The ASReview LAB software starts in the browser. For more options on starting ASReview LAB, see Start ASReview LAB.

Note

See Troubleshooting for common problems during installation.

Note

For users with Apple M1 computers, if you experience problems, follow the instructions.

Upgrade ASReview

Upgrade ASReview software with

pip install --upgrade asreview

Uninstall ASReview

Remove ASReview with

pip uninstall asreview

Enter y to confirm.

Warning

Note that your project files will not delete with this action. You find them in the .asreview folder in your home folder.

Server Installation

It is possible to run the ASReview software on a server or custom domain. Use the flags ip and port for configuration. ASReview should only be used in closed networks.

asreview lab --port 5555 --ip xxx.x.x.xx

Warning

Don’t use the development server in production. Read the Flask documentation about deploying a Flask app to production.

Install with Docker

ASReview LAB is also available as a Docker container. Make sure you have Docker installed on your machine.

To install and start ASReview LAB at http://localhost:5000, run the following:

docker run -p 5000:5000 asreview/asreview:latest

More advanced command line options can be given afterward, like this:

docker run -p 9000:9000 asreview/asreview  --port 9000

Tip

ASReview LAB is now installed. Open the URL in your host web browser: http://localhost:5000 and get started.

Mount local volume

To mount the container to your local project folder (or any other local folder), the -v flag can be used. To do so, adjust path-to-your-folder to your local folder. When a project folder is specified, ASReview LAB will store and load all its projects from this folder. Note that multiple containers can access the same folder.

docker create --name asreview-lab -p 5000:5000 -v path-to-your-folder:/project_folder asreview/asreview

Build a local image

For more information, see ASReview LAB GitHub.