progmax-dev/oppia

Tool for collaboratively building interactive lessons.

Oppia

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.

• Oppia.org community site
• Documentation
• Contributors' wiki
• Developer mailing list
• File an issue

Installation

Please refer to the developer wiki for full installation instructions. This is just a short summary for developers who would like to contribute:

1. 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 named opensource/oppia.

2. Navigate to opensource/oppia/ and run:

  git checkout develop
  bash scripts/start.sh

3. To run tests:

  bash scripts/run_tests.sh

Contributing

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 this wiki page for instructions on how to set things up and commit changes.
• All other contributors: please see our general contributor guidelines.

Support

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.

License

The Oppia code is released under the Apache v2 license.

Keeping in touch

• 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!