Skip to content

Latest commit

 

History

History
155 lines (98 loc) · 7.21 KB

SOFTWARE_INSTALLATION.md

File metadata and controls

155 lines (98 loc) · 7.21 KB
Raw

elimu.ai Software Installation 📦

The elimu.ai software consists of a collection of infrastructural and educational Android applications (see SOFTWARE_ARCHITECTURE.md).

Important

Note: Individual educational apps will not work unless you install the prerequisite infrastructural apps first.

To install elimu.ai's collection of apps, follow these step-by-step instructions:

Download & Install the elimu.ai Appstore Application

  1. Open a browser on your Android device and go to https://github.com/elimu-ai/appstore
  2. Scroll down to the "Download Application" section and press the link to open https://github.com/elimu-ai/appstore/releases:
  3. Press ai.elimu.appstore-<version>.apk
  4. Once the download completes, press "Open":
  5. Press the "SETTINGS" button:
  6. Press "Allow from this source":
  7. Navigate back to the previous screen:
  8. Press the "INSTALL" button:

Select Language of Instruction

Launch the Appstore application, and select the child's mother tongue as the language of instruction:

Once a language has been selected, the Appstore will connect to the webapp and download a list of applications to be installed:

Download & Install the Infrastructural Apps

Install the following infrastructural applications:

  1. Analytics
  2. Content Provider
  3. Launcher

Note: The first time you install an application via the elimu.ai Appstore, you might see a warning looking like this:

If you do, press the "SETTINGS" button, and select "Allow from this source":

Then go back to the previous screen to continue the installation.

Download the Educational Content

Before using the educational apps, you need to download the educational content to the Content Provider application:

Open the Content Provider application, and download the following:

  1. Sounds
  2. Letters
  3. Sound-to-Letter correspondences
  4. Words
  5. Numbers
  6. Emojis
  7. Images
  8. Audios
  9. Storybooks
  10. Videos

Download & Install the Educational Apps

Go through the remaining list of literacy/numeracy apps, and press "Download" and "Install" for each of them.

To verify that the educational apps are able to fetch content from the Content Provider, open "Vitabu" (Books) and make sure that a collection of storybooks appears:

Configure the Custom Launcher

Press the home button of the device, and select "elimu.ai Launcher":

Set as Default

Press the home button again, and select "ALWAYS":

Configure Text-to-Speech

If the default Text-to-Speech (TTS) on the device does not match the language selected in the Appstore, download a Text-to-Speech voice by going to Settings → Accessibility → Text-to-speech output. Then press the settings icon of "Preferred engine":

Then press "Install voice data" and select the same language as you did for the Appstore:

Configure Text-to-Speech Language 🌐

After downloading the voice, go back to the Text-to-Speech settings and change the language from "Use system language" to the same language as you chose for the Appstore:

Alternatively: Leave the setting at "Use system language", and then go to Settings → System → Languages & input → Languages, and switch the system language of the device to the same language as you chose for the Appstore:

Done! Start Learning 🚀

Congratulations, you have now successfully installed the elimu.ai software on your Android device! To start learning, open the elimu.ai Launcher, and press any of the unlocked spaceships:

elimu.ai - Free open-source learning software for out-of-school children ✨🚀

Website 🌐  •  Wiki 📃  •  Projects 👩🏽‍💻  •  Milestones 🎯  •  Community 👋🏽  •  Support 💜