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 chris@otree.org 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"
Note
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 otreehub.com.
- If you will use PyCharm or another text-based code editor, follow the steps here.