timshell / psirokuturk

Starter kit for running a psiturk experiment on heroku with jspsych.

Psirokuturk

A starter pack for running online experiments with Psiturk on Heroku.

Requirements

This project works with Python 3. Install requirements with

pip install -r requirements.txt

You can run experiment code in a number of ways:

• Preview index.html in your browser.
• To test the entire experiment, run make dev then visit http://localhost:22362. You can also preview the experiment page here.

Heroku Setup & Customization

1. Clone this repository
2. Create a Heroku account and install the Heroku toolbelt
3. Create a new app and add a Postgres database

    heroku create YOUR_APP_NAME --buildpack heroku/python
    heroku git:remote -a YOUR_APP_NAME
    heroku addons:create heroku-postgresql

4. Add university-specific information in the template. Check templates/ad.html, templates/error.html, and config.txt for any mention of "Bodacious" University and replace with a more appropriate reference. You should also put your IRB-approved consent form in templates/consent.html.

5. Once you've made your changes and committed, you can push to Heroku with the following command:

    git push heroku master

Usage

Post HITs

Start the psiturk shell with the command psiturk. Run hit create 30 1.50 0.5 to create 30 hits, each of which pays $1.50 and has a 30 minute time limit. You'll get a warning about your server not running. You are using an external server process, so you can press y to bypass the error message.

Contributors

• Fred Callaway
• Carlos Correa