alan-turing-institute / CounterfactualCovid19

Repository for the Leeds-Turing project for simulating a counterfactual history of the growth of COVID-19 cases in Europe
4 stars 2 forks source link
hut23 hut23-238

CounterfactualCovid19

Welcome to the Counterfactual Covid19 repository. This is a Leeds-Turing project that aims to visualise the counterfactual history of the growth of COVID-19 cases in Europe.

This repository contains two subdirectories:

Manual setup

Prerequisites

Both the frontend and the backend have their own set of prerequisites that you will need to install in order to run this app.

Running the app

Ensure that the PostgreSQL database is running:

pg_ctl -D /usr/local/var/postgres start

Then run the Django backend from the backend/ directory with:

poetry run python3 manage.py runserver

followed by the React frontend from the frontend/ directory with:

npm start

The app should then be available at http://localhost:3000

Docker setup

Prerequisites

Docker is the only prerequisite for the Dockerised version of the app.

Running the app

Launch the app by running the following:

docker-compose up -d

This will create a series of persistent docker-compose images so that future runs will be faster to start up. Note that although npm reports several vulnerabilities, we are using the latest versions of all requested libraries - no security fixes are available.

To cleanup all images and force a full rebuild do

docker-compose down -v --rmi all --remove-orphans