You can contact me here: [email protected]


Created by Sami-ul

Oftentimes smaller countries are excluded from the media as other events supercede them in impact. As a result people end up not knowing much about these smaller countries who are going through big changes and issues on their own. To combat this, I created this news application which encourages users to search through many countries to read the news about. This allows users to stay informed. It also attempts to create a summary by scraping the text from these news sites. I aim to publish this site in the future.


  • This application allows users to search for news by each country
  • Users can also recieve a summary of each article pulled
  • Due to the large variety of website designs for news services, it is hard to pull a summary for every single one
  • If errors occur in pulling news for a country, try going back and searching for that same country again
  • Clicking on a list object leads you to the webpage where the article is


  • The build folder in flutter has been gitignored, it should automatically recreate it when building with the flutter command, create an issue if not
  • Make sure you have the following tools installed
    • Python
    • Poetry
    • NodeJS
    • Flutter
  • In your command prompt, navigate to the same folder that this readme is located in and type ./setup_packages and press enter
    • This bat file will run all the necessary packaging operations for this app, it may take up to 2 minutes
    • You only need to do this once
  • After that is done, run the command ./run_app.bat
    • This will run all the components of the server which will be served on localhost
    • Then it will automatically run flutter in a chrome
    • Once you are done with this simply close the command prompt so the servers can close

Setup without scripts

  • This is slower than the bat files as the bat files run the commands asynchronously
  • To setup without scripts you will first need to update packages
    • To do this navigate to each folder in server
    • Enter these commands in terminal
      • cd server
      • cd newsapi
      • npm install
      • cd..
      • cd summarizationapi
      • poetry install
    • Now you have updated packages for poetry and npm
    • We will now update flutter packages
      • Navigate to webapp
      • Assuming you are in summarizationapi:
      • cd..
      • cd..
      • cd webapp
      • cd newsapp
      • flutter pub get
  • Now lets run the app
    • Navigate to each folder in server to start the backend
      • I have not hosted the api anywhere yet so thats why we need to do this
      • cd server
      • cd newsapi
      • node .
      • In a separate terminal go to summarizationapi
      • cd server
      • cd summarizationapi
      • poetry run python
        • If this failed then make sure you replace python with py or python3 or whatever you have python saved as
    • Now we can start the frontend
      • Use a separate terminal(separate terminal is only needed for this manual startup)
      • Navigate to webapp
      • Assuming you are in summarizationapi
      • cd..
      • cd..
      • cd webapp
      • cd newsapp
      • flutter run -d Chrome --release
    • Now the app will start

Work In Progress

  • Enhancing the summary function
    • Currently it incorporates incomplete quotations and picks weird portions that it deems as important
    • It is also extractive, future plans include making the summary abstractive


View Github