Skip to main content
Version: 3.2.x

PsiTurk

While honeycomb is optimized for use on a local application, we added functionality for usage with PsiTurk. The application will detect if it's being used in a Turk environment and will save the data to the default PsiTurk SQLite database.

Prebuilt version

When GitHub Actions is run, a PsiTurk build will be created automatically, and can be downloaded from its artifacts. The workflows responsible for building the PsiTurk application are .github/workflows/package.yml and .github/workflows/release.yml. The first one has to be triggered manually, the latter is triggered when you tag a release.

If this is all you need, the build instructions below can be skipped!

Build instructions

To set up your PsiTurk project, we provide a script that does the conversion. PsiTurk is a Python package used to manage HITs in Mechanical Turk. Before using the provided script, install PsiTurk.

You'll need to follow these steps (the path to the PsiTurk project should be a directory you wish to be created):

  • Build the application: npm run build

  • Move to the psiturkit directory: cd psiturkit

  • If it's the first time you're running the script:

    ./psiturk-it -p <PATH_TO_NEW_PSITURK_PROJECT>
  • To update an existing PsiTurk project (the path to the PsiTurk project should already exist from the previous steps):

    ./psiturk-it -U -p <PATH_TO_NEW_PSITURK_PROJECT>

Running PsiTurk

After that, just navigate to your newly created PsiTurk project directory.

shell> psiturk # start psiturk
psiturk> server on # start server
psiturk> debug # enter debug mode