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
  • Running the app locally
  • Loading the factors and treatments
  • Testing the app

Was this helpful?

Edit on GitHub
Export as PDF
  1. Getting Started

Running your experiment

Once you have created an experiment using empirica create.

PreviousCreating your experimentNextUpdating your experiment

Last updated 2 years ago

Was this helpful?

Running the app locally

Run the app on your local machine with one command:

empirica

This can take a few minutes.

This will start the app that you can access as a participant:

You can access the admin panel here:

Loading the factors and treatments

Treatments and factors can be entered via the admin panel.

Empirica also enables "experiment as code" by which experimental treatments and factors can edited directly in at .empirica/treatments.yaml.

Testing the app

To run a game, create a new batch with the games of treatments you want to use and click start on the batch.

Open a player tab by going to .

The player that you open with is cached on your browser. Whenever you start a game with this player, your local app will keep that information. To play again there are multiple things you can do:

  • Click on the Reset current session button in the bottom right menu to reset this player, and create a new game for this player to join.

  • Click on the New Player button in the bottom right menu to open a new tab with a different player (you will see tab with an id).

The app will automatically ("hot") reload when save changes to the code.

http://localhost:3000
http://localhost:3000/admin/
YAML
http://localhost:3000
http://localhost:3000