Skip to content

Mondo-News/global-engine

Repository files navigation

Our product delivers an interactive world map where users can visualize the top headlines per country, within fourteen countries from the Group of Twenty (G20) intergovernmental forum. The target user is someone interested in knowing what is going on from multicultural worldview, with it being specially useful for scholars in the fields of public policy and international affairs.

See documentation!

Features

Our product is a website with an interactive globe that allows the user to zoom in on trending news from specific countries. We focus on countries that are in the G20 and parse news articles in nine different languages and translate them to English. Per country and category, five news articles are shown, including a thumbnail picture, the headline, and a link to the article page. The articles are automatically categorized into the following categories:

Symbol Category
General
Technology
Health
Science
Business
Sports

By default, the articles shown are the most popular articles in that country from the last 24 hours. A filter on the world map level allows to change the categories to be displayed. In addition, a search bar on the world map level allows the user to search for specific keywords from within the headlines.

Try it yourself!

In order to install and run Mondo News on your own maschine, just download the repo and follow the instructions:

  1. Download the repo as .zip

  2. Navigate inside the global-engine-main directory and open a terminal/command prompt

  3. Install all dependencies from the requirements.txt file with: $ pip install -r requirements.txt

  4. Run dash_app.py

  5. Open the localhost URL printed out in the console after a little while with: python dash_app.y (Windows) OR python3 dash_app.py (MacOS)

API Reference

The data for Mondo News is mainly acquired and transformed by utilizing the following APIs.

Name Description
NewsAPI.org News API is a simple HTTP REST API for searching and retrieving live articles from all over the web.
deep_translator A flexible FREE and UNLIMITED tool to translate between different languages in a simple way using multiple translators.
pycountry pycountry provides the ISO databases.

Authors

About

Mondo News - Your visual global news platform

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages