A platform that uses real-time data to inform life-saving humanitarian responses to emergency situations

MagicBox is an open-source platform that uses real-time information to inform life-saving humanitarian responses to emergency situations. It's composed of multiple GitHub repositories designed to ingest, aggregate, and serve data.

You can read more about the project's purpose on unicefstories.org.

If you're an experienced dev and you'd like to get involved, chat with us here.

This repo is the "master" repo for all MagicBox-related projects. It hosts the documentation and other misc. resources for MagicBox. Code for other projects, like the API and front-end, are hosted in other repositories. See the project index for a full list of MagicBox-related repos and their respective maintainers.

We are looking for collaboration from the Open Source community! There's so much we want to do, including but not limited to: enhancing existing applications with new features, optimizing the technical tools and algorithms involved to accommodate data challenges, and bringing our work closer to the public to leverage their inputs via blog posts and tutorials.

• Please read our contribution guidelines for details on what and how you can contribute.
• Check out our Development Project Board.
• Look for tasks labelled good first issue under the Issues tab in each repo.
• Join our Gitter channel.

Project documentation is hosted on ReadTheDocs. Its current version is mostly suited for developers who want to understand more about our underlying tech. We are hoping to establish a more user-friendly version soon, one that is readable by our potential users (e.g. data scientists and decision-makers in UNICEF country offices, state governments, other UN agencies).

To understand MagicBox better:

• Read the README for each repo (full list is here). An architecture diagram of how these components are connected to one another is coming soon.
• Check out our Medium blog posts.