Siyavula

Our mission is to create and enable engaging, integrated, high-quality learning experiences in Mathematics and the Sciences; to have a long-lasting, enriching impact on learners and teachers in South Africa and globally; to constantly seek out and build the most relevant, effective technology whilst remaining rooted in the science of learning and instruction; and to engage and motivate young minds, helping them to master and develop the skills our future needs.

Learn more: https://www.siyavulaeducation.com/

Siyavula Practice

Siyavula Practice is an online Maths and Physical Sciences practice service for high school learners. The program provides learners with virtually unlimited questions that become progressively more difficult as correct answers are given. Because Siyavula’s practice adapts to the needs of the person practising by changing the difficulty and sequencing of questions, learners can progress at their own pace. They receive immediate feedback on the questions they do, with step-by-step solutions, and errors and misconceptions are corrected in real time. Siyavula Practice can be used by anyone with a computer, tablet or mobile phone (both smart and feature phones are supported) and an internet connection.

Learn more: https://www.siyavula.com/

Siyavula API

The Siyavula API provides an easy way to integrate Siyavula Practice into any application via a RESTful API.

Documentation

Siyavula API Python Pyramid Demo

This repo serves as a demo application written in Python Pyramid to integrate with Siyavula's API. To authenticate with the API you will need API credentials. If you do not yet have credentials, please contact [email protected].

Please note: this is only a demo application, the code was written to be as easy to understand as possible and as such might lack features you would expect in production level code.

Requirements

• Python >= 3.8
• Pip
• Venv
• Linux

Installation

Clone the repo

git clone [email protected]:Siyavula/siyavula-api-python-pyramid.git

Go to the siyavula-api-python-pyramid directory

cd siyavula-api-python-pyramid

Install the virtual environment and app

./install.sh

Make a personal .env copy

cp .env my.env

Set your username and password in my.env

Run the app

./start.sh

To demo a standalone activity, in your browser go to:

http://localhost:6543/standalone

To demo an assignment activity, in your browser go to:

http://localhost:6543/assignment

Dev installation(internal use):

To use the demo on your local instance run ./dev_start.sh instead of ./start.sh

./dev_start.sh

On some browsers the CORS cross-origin policy might block AJAX, JS or CSS loading in this case the easiest way to get around this is to use a plugin to override CORS headers.

• Chrome: https://chrome.google.com/webstore/detail/cors-unblock/lfhmikememgdcahcdlaciloancbhjino
• Firefox: https://addons.mozilla.org/en-US/firefox/addon/cors-everywhere/