Mobile Health App to Detect Chronic Conditions

Team Software Engineering project. This project is a mobile application built in BeeWare, which utilies machine learning algorithms and a pose detection module to detect chronic conditions in users.

How to install:

Install Python 3.8 (This version is needed to satisfy dependency requirements).

$ python3 --version

If your Python version is stated as 3.8, we can continue, if not create a virual enviroment with that Python version and be sure to select the Python 3.8 interperator:

OSX/Linux:

$ python3 -m venv venv
$ source venv/bin/activate

Windows:

PS > python3 -m venv venv
PS > ./venv/Scripts/activate

You should now have the (venv) prefix added to your terminal prompt as shown below.

Next, install Briefcase the library that manages the mobile deployment and development of the application:

(venv) $ python -m pip install -r requirements.txt

If you get an error when trying to install TF Lite, try this:

pip3 install --extra-index-url https://google-coral.github.io/py-repo/ tflite_runtime

How to Run:

(Tested on INB1102 PC's, Win11 and Macbook Air/Pro M1, other platforms may behave differently)

You should be able to run the application with the following (you will need to accept android SDK license agreements on auto-setup):

(venv) $ briefcase run android -r -u

This would compile the application where the terminal will take you through the proccess of hosting the app via a virutal device which you select.

Windows Bug:

You will find that when first starting the emulator it will hang on:

[healthapp] Starting emulator Pixel_3a_API_34_extension_level_7_x86_64...
━━━━━━━━━━━━━━━━━━━━ Starting emulator...

You must ctr+C to cancel the process and then run the command again (this is a known bug with the emulator NOT US).:

(venv) $ briefcase run android

(Potentially repeating until the emulator starts, this is a known bug with the briefcase library and emulator.)

Thanks for taking the time to visit our application.

Regards, Development Team (26551623@students.lincoln.ac.uk, 27203747@students.lincoln.ac.uk, 26457815@students.lincoln.ac.uk, 26379294@students.lincoln.ac.uk)