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/run_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'd like to make contributions to the codebase, please follow these instructions, which will walk you through setting things up, signing the CLA, and joining the developer mailing list. Thanks!
If you have any feature requests or bug reports, please log them on our issue tracker.
Please report security issues directly to admin@oppia.org.
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 public chat rooms on Gitter: https://gitter.im/oppia/oppia-chat and the #oppia channel on Freenode IRC. Drop by and say hello!