LogoLogo
  • Introduction
  • Getting Started
    • Setup
      • Windows WSL Instructions (new)
      • Windows WSL Instructions
      • Linux Instructions
    • Creating your experiment
    • Running your experiment
    • Updating your experiment
  • Conceptual Overview
    • Game Life Cycle
      • Customising when players submit stages
    • Concepts
    • Randomization & Batches
    • API
  • Guides
    • V2 Migration
    • Managing the Data
    • Special Empirica Components
    • The Admin Panel
    • Deploying Your Experiment
      • Ubuntu tutorial
  • Tutorials
    • Beginner Experiment: Prisoner's Dilemma
      • Part 1: Before you start
      • Part 2: Creating the Experiment in Empirica
      • Part 3: Getting Accustomed to the Code
      • Part 4: Coding the Prisoner's Dilemma Game
        • Part 4.1: Removing example code
        • Part 4.2: Intro Text
        • Part 4.3: Set up the game stages
        • Part 4.4: Build the "Choice" React Component
        • Part 4.5: Build the "Result" React Component
        • Part 4.6: Compute the Score
      • Part 5: Customizing the experiment
        • Part 5.1: Changing the number of rounds
        • Part 5.2: Turning the chat on and off
      • Part 6: Deployment
  • FAQ
    • I need help!
    • The Processes and Elements of an Empirica Experiment
    • Managing Players and Games
  • Resources
    • Helpful Linux Commands
    • Code Editors
    • Javascript and React
  • Links
    • Empirica website
    • Twitter
    • GitHub
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
Export as PDF
  1. Getting Started

Setup

PreviousIntroductionNextWindows WSL Instructions (new)

Last updated 11 months ago

Was this helpful?

  1. Run the installation script:

curl -fsS https://install.empirica.dev | sh

That's it, you're done! Proceed to create your experiment:

Running an older version?

If you are running on an older version and are encountering version issues, try running the curl command above again. It should reset your local install.

Upgrading

To upgrade the empirica command globally on your machine, you can either run empirica upgrade --global outside of any projects, or run the curl command above again.

Volta error

Some users have been seeing a Volta error that prevents empirica from properly managing node (here: ). It can be resolved it by installing the right versions of node manually and removing the volta lines from client/package.json and server/package.json.

A note about Windows Setup

Windows is currently not natively supported. Empirica does work on Windows with Microsoft's WSL 2.

The installation of WSL 2 has been greatly simplified since Windows 10 version 2004, released at the end of 2021. Windows 11 also benefits from the new much simplified procedure. The following documentation does not cover the new installation. If you are using Windows 10 2004 and higher, we recommend you look online how to install WSL 2, then you can follow the macOS/Linux procedure above.

Empirica is built on industry-standard open-source web technologies which run best in Unix-like operating systems such as Linux and macOS. ****

If you are a Windows user and get stuck at any point in the development process, please contact joshua.becker@ucl.ac.uk or join the for community-based technical support on a wide range of topics.

Creating your experiment
https://github.com/volta-cli/volta/issues/1744
Slack channel
Windows WSL Instructions