Home

Welcome to the turkAGL Wiki

What is turkAGL

In the Newport Lab, we frequently want to run artificial grammar learning experiments on Amazon Mechanical Turk (mTurk). However, doing so can be a confusing and challenging process. turkAGL is a library of artificial grammar learning experiment templates written by Katie Schuler. The templates use jsPsych (a javascript library) to create frequent types of AGL experiments and psiTurk to run them on Amazon Mechanical Turk. The goal of this wiki is to provide step-by-step instructions for (1) how to modify a template for your own use and (2) how to get your experiment up and running on mTurk.

• if you find a bug, please create an issue
• if you need help, please post your question on the google group

Table of Content

You need to do five basic things to run a jsPsych experiment on mechanical turk with psiturk:

1. [Setup required accounts](Setup required accounts)
2. [Install and configure psiturk](Install and configure psiturk)
3. [Modify the psiturk templates](Modify the psiturk templates)
4. [Modify the main experiment template](Modify the main experiment template)
5. [Run your experiment](Run your experiment)

Beyond these basics things, you may also want to:

• [Retrieve your data](Retrieve your data)
• [Run your experiment on a server](Run your experiment on a server)

List

• Download an experiment template to work from
• Modify the psiturk parts of the template
• Create your actual experiment
  • Modify the Javascript and jsPsych parts of the template
  • Debug your experiment locally
• Run your experiment on a server
  • Setting up a Digital Ocean server
  • Get psiturk installed and configured on your server
  • Upload your experiments to your server
  • Testing your experiments in the mTurk sandbox
  • Running your experiments
• Get your data out of participants.db

ad.html consent.html complete.html thanks.html default.html error.html exp.html