/magicbox

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

BSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

MagicBox

Chat on Gitter Documentation Status Build Status

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

About

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.

What's 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.

Contributing

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.

Documentation

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).

Resources

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.