Installing Oppia

If you are looking for more elaborate instructions on how to get started with Oppia, go to setting things up.

To install the Python 3 version of Oppia, follow these instructions:

You might need to install an older version of Oppia that uses Python 2. Only do this when you need to get some older code working or you need to make some changes to a release that is not in Python 3 yet. To do so, follow these instructions for your platform:

  • Linux

  • Mac OS

  • Windows (might be a bit complicated, we recommend to use Linux or Mac if you can)

If you run into any problems during installation, please read these notes and the troubleshooting page.

Take a look at our guide for getting started with some common code editors.

Warning: You should always edit Oppia code on your local machine. Do not use web-based editors like github.dev or the editor on github.com. These web-based editors won’t run the automated checks that run on your local machine. Pushing without these checks just means that the tests will fail on your PR.