Command Line Tools HIT Creation - gideongoldin/TurkGate GitHub Wiki

The Command Line Tools (CLT) files are for creating external HITs that go through TurkGate using Mechanical Turk's Command Line Tools.

  1. Create a new directory for your HIT by going to the hits folder in your CLT installation and running makeTemplate -target survey -template external_HIT (on OS X run ./makeTemplate.sh -target survey -template external_HIT. This will create a folder named survey in the hits folder. If you already have a folder named survey or you want to change the name for any reason, change the -target parameter and see step 3.
  2. Navigate to your TurkGate installation (i.e., index.php) in your browser. Fill in the form and download the .input, .properties and .question files.

Generate

  1. Put the downloaded files in your survey folder, overwriting the existing files. If you created the HIT with a name other than survey, change the names of the files to match the name of the HIT.
  2. Update the .properties file with the properties you want for your survey. Don't change the annotation field.

The HIT is now ready to be created like any other CLT HIT, using the run script. If this is the first time you are creating a TurkGate HIT, you might want to create it in the requesters' sandbox to try it out. You can do this using the -sandbox parameter of the run script.