Home

In the Newport Lab, we frequently want to run artificial grammar learning experiments on mechanical turk. However, doing so can be a confusing and challenging process. The turkAGL is a library of artificial grammar learning experiment templates written by Katie Schuler. The templates use jsPsych (javascript library) to create frequent types of AGL experiments and psiturk to run them on 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 mechanical turk.

• 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:

6. Retrieve your data
7. Run your experiment on a server

Welcome to the turkAGL wiki!

• What is turkAGL and how can it help you?
• Getting started
  • Create an AWS account
  • Become a mechanical turk requester
  • Create a psiturk secure ad server account
  • [Install psiturk](Install psiturk)
• Configure psiturk for your experiment
  • Setup psiturkconfig with psiturk and AWS access keys
  • 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