Empirica is build on industry-standard open-source web technologies. We will first need to install Empirica dependencies. Please select your Operating System below for instructions.
Install Node.js via https://nodejs.org/en/ (download and install the LTS bundle on the left)
Install Meteor with instructions at https://www.meteor.com/install
If you are a windows user, you must first complete this guide in order to install the necessary developer tools for Windows. If you are a MacOS/Linux user, you can proceed to 'Quick Start.'
Install and configure the latest version of Windows Linux Subsystem (WSL2). **Step 1 is the most involved component**
Within WLS, install NVM.
In order to install WSL2 and Ubuntu 20.04, follow the steps in this guide: https://docs.microsoft.com/en-us/windows/wsl/install-win10
If you prefer video instructions, watch this great 5 minute tutorial: https://www.youtube.com/watch?v=D7Em1wjMiak (commands in the description)
Enable the Windows Subsystem for Linux
Ensure you meet the requirements for WSL2
Enable the Virtual Machine feature in Windows (see screenshot below)
Download the WSL2 update package
Set WSL2 as your default Linux system
Open Microsoft store, search for Ubuntu 20.04, and install it
Launch the terminal and follow the prompt to create a new username/password (see screenshot below).
Our instructions follow this guide: https://tecadmin.net/install-nodejs-with-nvm/
Note: Use the right-click to paste in the command line.
Enter the following commands into your Ubuntu terminal:
curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash # Download and installsource ~/.profile # Reload system environmentnvm install lts/erbium
If you are not familiar with using the command line, you can find some helpful Linux commands here:
Once your system is configured as described above...
Replace my-experiment
with the name of your experiment (no spaces).
npx create-empirica-app my-experimentcd my-experimentmeteor
Edit files in this folder to see instant updates in the browser.
Have fun!
If you don't have a code editor of choice, you can find our advice at: