Skip to main content

An open platform for science on Amazon Mechanical Turk

Project description

Build Status Latest Version Coverage Status License DOI

Please visit for more information.

Psiturk Google Group


psiTurk v3 has been released! See the migration guide here.

psiTurk v3 does not support the psiturk ad server. If you still need the psiTurk ad server, use psiTurk v2.3.12, and remove all HTML comments from your ad.html file. Versions less than v2.3.12 will not be able to post HITs due to a change implemented by the psiturk ad server's hosting provider. You can upgrade to psiturk v2.3.12 by running pip install --upgrade psiturk=2.3.12.

Python versions

  • Psiturk v2 supports python 2 and python 3. Documentation for psiturk v2 is available here
  • Psiturk v3 is python 3 only. Documentation available here


Check out a clone of this repo, and install it into your local environment for testing (consider installing into a virtualenv):

git clone
pip install -e psiTurk

A test suite can be run using pytest from within the base directory of psiturk.


To credit psiTurk in your work, please cite both the original journal paper and a version of the Zenodo archive. The former provides a high level description of the package, and the latter points to a permanent record of all psiTurk versions (we encourage you to cite the specific version you used). Example citations (for psiTurk 2.3.7):

Zenodo Archive:

Eargle, David, Gureckis, Todd, Rich, Alexander S., McDonnell, John, & Martin, Jay B. (2020, January 6). psiTurk: An open platform for science on Amazon Mechanical Turk (Version v2.3.7). Zenodo.

Journal Paper:

Gureckis, T.M., Martin, J., McDonnell, J., Rich, A.S., Markant, D., Coenen, A., Halpern, D., Hamrick, J.B., Chan, P. (2016) psiTurk: An open-source framework for conducting replicable behavioral experiments online. Behavioral Research Methods, 48 (3), 829-842. DOI:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PsiTurk-3.3.0.tar.gz (330.8 kB view hashes)

Uploaded source

Built Distribution

PsiTurk-3.3.0-py3-none-any.whl (359.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page