skamieniarz / newspie

A minimalistic news aggregator built with Flask and powered by News API.

NewsPie

A minimalistic news aggregator built with Flask and powered by News API.

Link to live demo

Prerequisites:

1. Python3.
2. Dependencies from requirements.txt or Pipfile.lock (preferably in a virtual env).
3. API key for News API. It's free for non-commercial projects (including open-source) and allows 500 requests per day. Once acquired, save it as NEWS_API_KEY environment variable or directly as string to API_KEY in news.py. Just don't share it or upload the code with it.

Starting:

1. Run python news.py or python3 news.py (depending on the environment) in the terminal while in the root of the repository.
2. Go to http://127.0.0.1:5000/ address in the web browser.

Features:

1. Get top articles headlines and their URLs by country and/or category.
2. Search articles up to a month old. Looks for a given query in the titles. Language/country independent results. Relevancy decides.
3. Results received from News API are cached for 5 minutes.
4. Country saved as a cookie.
5. Responsive UI.
6. Dark mode/theme.

Open-source used:

• Flask
• jinja
• Pico.css
• requests
• requests-cache