oppia/oppia-ml

Name: oppia-ml

Owner: Oppia

Description: null

Created: 2017-05-25 18:29:31.0

Updated: 2017-08-09 19:07:37.0

Pushed: 2018-02-16 05:56:25.0

Homepage: null

Size: 98

Language: Python

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Oppia-ml

Oppia-ml is a supplementary component which is used with Oppia for training machine learning models on a separate VM instance. Oppia puts job requests for training a classifier in database. Oppia-ml picks this job requests one by one, trains classifier for these requests and stores the result of training back into database. Oppia uses this stored results to predict outcome for answers.

Oppia-ml is written in Python and uses various machine learning libraries for creating classifiers.

Installation
Installing on your development machine
  1. Clone this repo in folder oppia-ml.

  2. Open terminal and navigate to oppia-ml folder and run:

    checkout develop
     scripts/start.sh
    
Deploying Oppia-ml on VM instance
  1. Clone this repo in oppia-ml folder of your VM instance.

  2. Install Supervisor on VM instance. Generally it can be installed by running simple pip command. You need superuser privileges to install it on VM. if this command does not work then follow instructions on official installation page.

    install supervisor
    
  3. Navigate to oppia-ml folder in terminal and run following commands:

     scripts/deploy.sh
    
  4. Add shared secret key in VM and in Oppia for secure communication. Shared key on VM is added using GCE metadata. Add two key - value pairs in metadata, one for shared_secret_key and other is vm_id. VM will automatically get the ID and secret from metadata. Shared key on Oppia can be added by going to /admin page of your Oppia host. On this page go to the 'Config' tab where there will be one section for VMID and shared secret keys in which one can add as many vm_id and shared_secret_key as needed.

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.

Licence

The Oppia-ml code is released under the Apache v2 license.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.