TRUSTLAB

Web-based multiplayer strategy games and economics experiments to measure trust. This software is developed with the financial support of the European Research Council under the European Community’s Horizon H2020 Program (H2020-ERC-2014-CoG Grant Agreement n° 647870).

The trustlab had a first life under the form of limesurvey experiments which were designed by Anne L'Hôte, Jérôme Hergueux and Yann Algan. To learn more see http://github.com/medialab/mango_trust and : Hergueux, Jérôme, et Nicolas Jacquemet. « Social Preferences in the Online Laboratory: A Randomized Experiment ». Experimental Economics 18, nᵒ 2 (1 juin 2015): 251‑83. https://doi.org/10.1007/s10683-014-9400-5.

Getting started

Trustlab is based on oTree, a Python, Django-based framework for econn-games. Please refer to the following article regarding oTree:

Chen, D.L., Schonger, M., Wickens, C., 2016. oTree - An open-source platform for laboratory, online and field experiments. Journal of Behavioral and Experimental Finance, vol 9: 88-97

Trustlab also includes a working version of the Implicit Association Test, and several changes to the base games it restricts itself to (Trust, Dictator, Public Good)... among other things.

If you're comfortable with the oTree platform, you should be up-to-speed in no time. Nevertheless, there are several idiosyncrasies you should be aware of in order to run Trustlab properly. They are listed below, and in the Wiki.

Prerequisites

You may want to refer to oTree's installation tutorial. In a nutshell, you need Python 3.5 and pip, to be able to install oTree using the latter (pip3 install -U otree-core).

It is strongly suggested that you use a virtualenv in order to run your platform in the best possible way. If you do so, you should follow this tutorial to know how to set up the necessary environment variables for your instance of Trustlab.

Installing

• Clone this directory:

git clone git@github.com:medialab/trustlab.git

• Install the dependencies:

pip install -r requirements_base.txt

• Set up the necessary environment variables (see how-to for virtualenv):

export OTREE_SECRET_KEY=...
export OTREE_ADMIN_PASSWORD=...
export OTREE_PRODUCTION=False
export OTREE_ADMIN_PASSWORD=...
export OTREE_SECRET_KEY=...
export OTREE_AUTH_LEVEL=STUDY
export OTREE_LANGUAGE_CODE=...
export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...

• Reset your DB to run the migrations. From the console at the root of your project:

otree resetdb

• If your OTREE_PRODUCTION setting is setting to True, build the static assets:

otree exportstatic

• Run the server.

otree runserver

• Check out http://localhost:8000/, and use the credentials you've registered in your related environment variables to log in.

Deployment

The Trustlab project has been successfully deployed on an instances of Heroku's dynos. Please refer the server deployment documenation in oTree for further information.

Don't forget to set up your environment variables, regardless of the deployment strategy.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

• Daniel L. Chen, Martin Schonger and Christopher Wickens - Initial work on oTree - oTree-org
• Davy Peter Braun - Initial work on Trustlab, including animated simulations, IAT... - dheavy
• Paul Girard - Overview of project - paulgirard

License

This project is licensed under a modified version of the MIT License, matching that of oTree - see the LICENSE.md file for details.

Acknowledgments

• Thanks to Chris Wickens for his help, both in person and on the oTree newsgroup
• Hat tip to the oTree community