Installing oTree on macOS

Important note

If you publish research conducted using oTree, you are required by the oTree license to cite this paper. (Citation: 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)

If the below steps don’t work for you, please email with details.

Step 1: Install Python

  • Download and install Python
  • In Finder, search for and open the “Terminal” app:

Step 2: Install oTree

Enter this command at the prompt:

pip3 install -U "otree>=5a"


This documentation is for oTree Lite. If you need maximum compatibility with existing oTree apps, switch to this documentation.

Next steps

  • If you will use oTree Studio (recommended), go to
  • If you will use PyCharm or another text-based code editor, follow the steps here.