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):
The ASReview LAB software starts in the browser. For more options on starting ASReview LAB, see Start ASReview LAB.
See Troubleshooting for common problems during installation.
For users with Apple M1 computers, if you experience problems, follow the instructions.
Upgrade ASReview software with
pip install --upgrade asreview
Remove ASReview with
pip uninstall asreview
y to confirm.
Note that your project files will not delete with this action. You find them in the .asreview folder in your home folder.
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
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
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.