Oppia is an online learning tool that enables anyone to easily create and share interactive activities (called 'explorations'). These activities simulate a one-on-one conversation with a tutor, making it possible for students to learn by doing and get feedback.
Oppia is written using Python and AngularJS, and is built on top of Google App Engine.
Please refer to the developer wiki for full installation instructions. This is just a short summary for developers who would like to contribute:
-
Create a new, empty folder called
opensource/within your home folder. Navigate to it (cd opensource), then fork and clone the Oppia repo. This will create a new folder namedopensource/oppia. -
Navigate to
opensource/oppia/and run:
git checkout develop
bash scripts/start.sh
- To run tests:
bash scripts/test.sh
bash scripts/run_js_tests.sh
bash scripts/run_integration_tests.sh
The Oppia project is built by the community for the community. We welcome contributions from everyone, especially new contributors.
You can help with Oppia's development in many ways, including art, coding, design and documentation.
- Developers: please see the CONTRIBUTING file for instructions on how to set things up and commit changes.
- All other contributors: please see our general contributor guidelines.
In addition, if you're making contributions to the codebase, please sign the CLA so that we can accept your contributions.
- If you're contributing as an individual, use the individual CLA.
- If your company owns the copyright to your contributions, a company representative should sign the corporate CLA.
If you have any feature requests or bug reports, please log them on our issue tracker.
Please report security issues directly to [email protected].
The Oppia code is released under the Apache v2 license.
- Blog
- Discussion forum
- Announcements mailing list
- Social media: G+, YouTube, FB, Twitter
We also have a chat room on Gitter: https://gitter.im/oppia