Giter Site home page Giter Site logo

rakeshhotker / hstw Goto Github PK

View Code? Open in Web Editor NEW

This project forked from terencegrover/hstw

1.0 0.0 0.0 1.21 MB

Sentiment analysis tool aggregating world news, generating indices and displaying it all on a 3D globe.

Home Page: https://hstw.io

License: GNU General Public License v3.0

Shell 0.02% JavaScript 43.02% Python 40.46% CSS 15.39% HTML 1.10%

hstw's Introduction

GitHub Language Count

๐ŸŒ How's The World ๐ŸŒ

A sentiment analysis tool that aggregates news sources from around the world to generate a happiness index. This project aims at facilitating news consumption and to have a concentrate of all important news within a single glance. The project is built using a combination of Python Flask for the backend and React for the frontend.

Screenshot 2023-01-16 at 20 31 03

Features

  • Generates a happiness index based on the sentiment analysis of news headlines
  • Visualizes the data on an easy-to-use dashboard
  • Automated data collection process using web scraping techniques
  • Responsive design, can be accessed on any mobile device

Technologies

  • Backend: Python Flask, pandas, nltk, boto3, feedparser
  • Frontend: React, react-router-dom, react-globe.gl, CSS, Chart.js

Installation

  • Clone the repository

For Backend

  • I recommend the usage of a virtual environment
  • Install the dependencies using pip install -r requirements.txt
  • You might have to install nltk additional dependencies manually with 'python -m nltk.downloader all'

For the Frontend

  • Run the backend server using flask run
  • Install the dependencies using npm i
  • Run the frontend using npm start

Usage

Contributors Guide

  • Reinforcement of the backend
  • Updating the news sources
  • Better impartiality in news source and fine-tuning of the scraping algorithm
  • Development of the UI
  • Addition of Chart.js visualisation
  • Implementation of custom iPhone shortcuts for the visualization to be even faster and easier
  • Instagram story generator for particular news that need extra-sharing

Contributing

  • I am currently the sole contributor, but I welcome any contributions and suggestions from the community to improve and expand the capabilities of this tool
  • Please feel free to submit a pull request or open an issue

License

  • The project is not to be used for any commercial use wihout the prior agreement of the original Author

Author

โค๏ธ

hstw's People

Contributors

terencegrover avatar al366io avatar rakeshhotker avatar

Stargazers

Roman avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.