A web app for labelling texts by SDG written in Python Dash.
The application is designed to facilitate the collection of texts labelled by Sustainable Development Goals (SDGs). It consists of two main components: a front-end web application written Python Dash and a back-end database which can be either a native MongoDB or Azure Cosmos DB for MongoDB.
The application can be run locally or on the remote server using Docker. For details about deployment, read the sections below.
The application has been developed in Python 3.10.
The simplest way to get started with the app is to clone the repository and follow the instructions in another README.md.
To run the application without Docker, you will need two things: a virtual Python environment and a connection to a MongoDB instance (either local or remote).
- Create a virual environment by following the instructions from the official documentation.
- Install the dependencies with
pip install -r requirements.txt. - Specify the required environment variables (see below), including the connection to MongoDB.
- Run the app with
python app.py.
You also need a connection to a MongoDB instance which must have two collections populated with data in a specific format. The two collections are users (which cannot be called anything else) and
texts collection (whose can be called anything you want). You can manually import sample data JSON files under docker/ directory or use your own data that follows the exact same format.
TBC.
Before deploying a web app to Azure Web Services via GitHub Actions, set
both WEBSITE_WEBDEPLOY_USE_SCM (source) and SCM_DO_BUILD_DURING_DEPLOYMENT (source)
to true in application settings.
TBC.