{"id":16294728,"url":"https://github.com/thealphadollar/messiah","last_synced_at":"2026-01-19T23:02:54.574Z","repository":{"id":100459286,"uuid":"152110370","full_name":"thealphadollar/messiah","owner":"thealphadollar","description":"Messiah: The Mighty Son Of God Is Here To Help You Through Times Of Calamity","archived":false,"fork":false,"pushed_at":"2019-05-02T18:43:29.000Z","size":5591,"stargazers_count":2,"open_issues_count":10,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-07T21:34:09.695Z","etag":null,"topics":["azure","backend","data","data-analysis","flask","frontend","materialize","natural-disasters"],"latest_commit_sha":null,"homepage":"https://messiah-cfd.herokuapp.com/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thealphadollar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-08T16:17:33.000Z","updated_at":"2019-05-02T18:43:34.000Z","dependencies_parsed_at":"2023-05-05T22:27:02.239Z","dependency_job_id":null,"html_url":"https://github.com/thealphadollar/messiah","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thealphadollar/messiah","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thealphadollar%2Fmessiah","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thealphadollar%2Fmessiah/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thealphadollar%2Fmessiah/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thealphadollar%2Fmessiah/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thealphadollar","download_url":"https://codeload.github.com/thealphadollar/messiah/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thealphadollar%2Fmessiah/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28588969,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T20:45:59.482Z","status":"ssl_error","status_checked_at":"2026-01-19T20:45:41.500Z","response_time":67,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azure","backend","data","data-analysis","flask","frontend","materialize","natural-disasters"],"created_at":"2024-10-10T20:16:17.839Z","updated_at":"2026-01-19T23:02:54.557Z","avatar_url":"https://github.com/thealphadollar.png","language":"HTML","readme":"# Microsoft CodeFunDo++ 2018 (Team Sorcerers)\n![Messiah logo](readme_logo.jpeg)\n\n## Contributing\n\nSince the project is open source everyone is welcome to contribute.\n\nPlease refer to CONTRIBUTING.md for more details.\n\n\n## Implementation\n\n### Deployment\n\nThe app isn't yet deployed anywhere. It can be viewed by running src/index.html in the local browser.\nYou are free to volunteer :)\n\n\n### Directory Structure\n\n--\u003e Repo \u003cbr/\u003e\n  * ---\u003e logs \u003cbr/\u003e\n      * ---\u003e backend.log \u003cbr/\u003e\n      * ---\u003e frontend.log \u003cbr/\u003e\n  * ---\u003e src \u003cbr/\u003e\n      * ---\u003e config \u003cbr/\u003e\n          * ---\u003e stores important configuration files\n          * ---\u003e loggerConfig.yaml\n      * ---\u003e frontend \u003cbr/\u003e\n          * ---\u003e all the code using HTML, JS for frontend \u003cbr/\u003e\n          *  ---\u003e _Dockerfile_ \u003cbr/\u003e\n          *  ---\u003e _README.md explaining backend_ \u003cbr/\u003e\n      * ---\u003e backend \u003cbr/\u003e\n          * ---\u003e data \u003cbr/\u003e\n              *  ---\u003e database files (if not being stored remotely)\u003cbr/\u003e\n          *  ---\u003e python and flask backend\u003cbr/\u003e\n          *  ---\u003e _Dockerfile_\u003cbr/\u003e\n          *  ---\u003e _README.md explaining frontend_ \u003cbr/\u003e\n      * ---\u003e _docker-compose file_\u003cbr/\u003e\n  * ---\u003e docs\u003cbr/\u003e\n      * ---\u003e _basic documentation for the entire project explaining_ \u003cbr/\u003e\n  * ---\u003e other files\u003cbr/\u003e\n\n### Dev Instructions\n\nWhile developing the project, we will be using Pipenv to manage dependencies.\nThe following instructions will help in setting your environment for the first time\"\n\n```bash\nsudo pip install pipenv\ncd /path/to/repo\npipenv shell --three\npipenv install --dev\n```\n\nNow you're in a virtual environment with all the required packages (even those for\nmarked as only for development). To start the virtual environment again,\n\n```bash\ncd /path/to/repo\npipenv shell\n```\n\nInstall new packages only after activating the virtual environment to make sure it\ngets added to the Pipfile automatically.\n\n```bash\npipenv install [PACKAGE_NAME]\n```\n\nNOTE: Add `--dev` at the end if the package is required only while developing and not\nusing.\n\n### Frontend GUI \n\n* --\u003e A Landing page\n  * --\u003e Title of our project\n  * --\u003e Search Bar / Option to give us browser location\n  * --\u003e A revolving globe (just for show)\n  * --\u003e A Navbar having links to different services we are going to provide (as mentioned below)\n* --\u003e About Us\n  * --\u003e Simple mission, and introduction about team members.\n* --\u003e A unified dashboard (a single dynamic page) showing the below data:\n    * --\u003e Page having, map interface saying previous earthquake data, for set location.\n    * --\u003e Page, predicting the possibility of the natural disaster, judging the location of the user (optional)\n    * --\u003e Page having, map interface showing present location of the user (and plausible relief camp placements, and the shortest route to the closest one)\n    * --\u003e Page, which shows precautions and tips on the basis of location of the user\n* --\u003e _A static page, displaying the SMS functionality procedure, and set up._\n* --\u003e Scope for further improvements(whatever we couldn't do), github link to the repo, and vote of thanks.\n\n## Idea Synopsis\n\n### Who are we\n\nWe are a group of three sophomore students. The team members are as follows:\n\n1. Anuprava Chatterjee ([@theartist007](https://github.com/theartist007))\n2. Navaneeth Suresh ([@themousepotato](https://github.com/themousepotato))\n3. Shivam Kumar Jha ([@thealphadollar](https://github.com/thealphadollar))\n\nAll three of us are from different regions and different backgrounds and have a diverse understanding of the conditions of calamities in our region. This would, I believe help us in fabricating a better solution.\n\n### What are we planning to build\n\nWe are planning to build a service to help save lives and prevent economic losses through mechanisms to predict, prevent, or manage the impact of natural disasters, as accurately as possible and feasible using the dataset procurable.\nThe service would:\n\n1. Predict (show probability) the possibility of a natural disaster, in any given location, set by the user.\n\n2. Show the user/relief providers the most appropriate area to set the camp in.\n\n3. Guide the user to all the relief points such as government schools, hospitals and police stations located within a specified radius and also provide a guided path to the nearest one of them.\n\n4. Provide the user with valuable precautions which can be implemented well in advance based on the geography and topography of the location the user resides in. These tips will be such as \"build houses with x type of pillars to ensure sturdiness at times of earthquake\".\n\n5. A person would also be able to list the danger he is in, and accordingly, a response team can be assigned to him (or can volunteer to help him). A distress receiver and responder will be made available.\n\n6. Relief centers can list the type of services they can provide and the area they can cover and accordingly people can request and post about their needs on the forum. At times of ongoing disasters, a critical dynamic page will list all of these for each geographical area separately.\n\n7. Show data of previous natural disasters of the area, and grossly present the damage done by them to property and life.\n\n### How does it work\n\nEach bullet point has been explained with accordance to its order in the previous heading.\n\n1. Using the global dataset available (which is, frankly, not up to the mark) we can form a pattern in the occurrence of global disasters and combining it with the susceptibility of a disaster according to geography, we can come up with the probability of various disasters occurring in near future.\n\n2. Will be done by parsing a user's location (or manually taking it for relief centres) and then assessing the population density distribution of the area (in peace times) and also the impact of the disaster if any ongoing. Through testing multiple algorithms, a suitable weight will be chosen for the two.\n\n3. In a similar manner as above, once a user's location is received we can show him the locations on a map and have a path set to the nearest station; both graphical and textual manner.\n\n4. Dividing the area based on disaster data; such as earthquake-prone, flood-prone and then accordingly devising a set of precautions and instructions which can help lower the damage done to life, property and other assets.\n\n5. A separate \"specific\" dashboard shall be created for users / relief providers to interact and list the items they need/provide and the list is curated in a database and will be used in sync to match the needy with the providers at the right places and quickly.\n\n6. Same as above; just different dashboard for relief centres and multiple other options so they can mark what all they have, and if they are occupied at the moment in some relief operation.\n\n7. This can be done easily using the available surveys and records, arranging them in a suitable JSON-like format so that template pages can be filled with them.\n\n### How users can get started with the project\n\nThe project will be provided as a web application in order to pass the hurdle of platform limitation. A simple, elegant and intuitive user interface will be provided along with a simple \"help\" to get the users, as well as relief providers, get started with the platform. Since the application will be a web app, in the future it'll be easier to create mobile apps for the same.\n\nThe user will get a map-view of the location he is in, up to a certain radius, which will show locations of relief centers and the directions to the nearest of them. They can also get personalized help options, and relief procedures based on their response in the forum. _There will be multiple dynamic dashboards for different features such as maps, past data, relief calls etc._\n\n_An appealing feature of the website will be the implementation of the SMS (and telephonic, if time permits) endpoints. This will ensure that people without internet can also gather information and send help calls to the website without having to go to the website. This will be done as any other automated SMS API endpoint works; a set of keywords to recognize the type of message and then providing all the services (for example providing textual directions to the nearest relief point) through SMS._\n\n### What dataset(s) are we using\n\nWe are planning to build a web app based on the dataset of the whole world (or anything close to it). We've been testing data from [gisresources](http://www.gisresources.com/natural-disasters/) or [emdat](https://www.emdat.be/) on various scenarios. Due to the vastness of the dataset, it is not viable to train the deep learning models on our systems, and hence Azure Cloud Resources will be utilized in the process of assessment of various datasets and gauging their accuracy.\n\nWe will be using multiple geographical data to decide the zones of disaster-prone areas and population density. We will also procure (or produce) data for predicting and providing precautions according to the division of zones. We have been looking at [Azure's Earth Science data from NASA](https://earthdata.nasa.gov/) and [Azure's US Government Data](https://www.census.gov/data.html) for viable datasets in aiding in our purpose.\n\nSpecifically for the part of prediction, we need to look at the pattern of natural disasters for the past decades and draw a pattern and then deduce the possibility and effects of a disaster in an area. The estimate of future damage will be based on past data and will be calculated using simple data analysis techniques.\n\n### What technologies are we using\n\n- Python 3.6.5 with Pipenv\n- JavaScript\n- HTML5 + CSS3\n- GitHub for hosting\n- [Microsoft Azure Data Science Virtual Machine](https://azure.microsoft.com/en-in/services/virtual-machines/data-science-virtual-machines/) for training prediction models\n- Microsoft Azure Cloud for deployment\n- _[Docker](https://www.docker.com/) to deploy as containers by handling microservices_\n- [Flask](http://flask.pocoo.org/)\n- [Elasticsearch](https://www.elastic.co/products/elasticsearch) as a distributed RESTful search engine\n- _[Twilio SMS API](https://www.twilio.com/docs/sms)_\n- Maps API (Opensource [LeafletJS](https://leafletjs.com/) with [OpenStreetMap](https://openstreetmap.org) as tile provider)\n- Geocoding API (Opensource [Nominatim](https://nominatim.openstreetmap.org/) API to search from OpenStreetMap data)\n- SQL Database as a service from [Azure](https://azure.microsoft.com/en-in/services/sql-database/).\n\n### Final Notes\n\nWe will be trying to give equal resources and time to every field of the problem statement but our main object will be to create a system which can help at the times of disaster and is even remotely accessible (_by SMS for instance_). A simple interactive platform between helpers and needy will go a long way in improving the scenario and dependency on various social media platforms. We also have the plan (a far-fetched one) of embedding a system in the platform where people can add family members and then at times of disaster mark themselves safe (or in danger) and our system will do the hard work of carrying their message to all.\n\nWe will be testing the technologies (mentioned above) and assessing if they need to be improved (or changed) to achieve the optimum efficiency for the goal.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthealphadollar%2Fmessiah","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthealphadollar%2Fmessiah","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthealphadollar%2Fmessiah/lists"}