News_Teller

KO | EN

gitlite — search

#javascript #python #hacktoberfest #golang #rust #deep-learning #docker #macos #cli #pytorch #security #ios #mcp #openai

(★ 11)

No description available.

News_Teller Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 📰 News_Teller – AI-Powered Smart News Digest

> A Flask-based web app that fetches live news from across the world and summarizes them using NLP techniques — with category filters, keyword search, sentiment analysis, and a clean responsive UI.

---

## 📌 Project Overview

**News_Teller** allows users to:
- Get the latest top headlines or search for specific news using keywords
- Select a country and browse news by category
- View summaries generated using the LSA summarizer from Sumy
- See sentiment analysis (positive, neutral, negative) using TextBlob
- Read news cards with source, timestamp, summary, and mood icons

It’s your **smart, real-time news reader** — built for global awareness with NLP + automation.

---

## 🌟 Key Features

- 🔍 **Search by Keyword** (e.g., “AI”, “Elections”, “Cricket”)
- 🌐 **Filter by Category**: Technology, Sports, Entertainment, Business, etc.
- 🌏 **Country Selector** (with default set to India)
- 📄 **2-line Summarization** using LSA
- 🧠 **Sentiment Classification** (Positive / Neutral / Negative)
- 🎨 **Modern Responsive UI** with animations and a blurred background effect
- 🧭 Shows **timestamp**, **source**, and **summary** for each article

---

## 🖼️ Sample UI Preview

> Background: Animated Earth + Glassmorphism UI  
> Search & filter from a single screen  
> Responsive on desktop + mobile

🧠 Summary and sentiment are shown with emojis and tooltips to explain context.
## 🖼️ Sample Outputs

Here are some example screenshots from the News Teller app:

![Search Example](https://github.com/Shubham1919284/News_Teller/blob/20e967b33766f617bb6239fa24b7139ce8db8956/Screenshot%202025-07-09%20025956.png)
*Search results with sentiment and summary*

![Category Filter](https://github.com/Shubham1919284/News_Teller/blob/20e967b33766f617bb6239fa24b7139ce8db8956/Screenshot%202025-07-19%20064254.png)
*Category-wise news filtering*

![Country Selection](https://github.com/Shubham1919284/News_Teller/blob/20e967b33766f617bb6239fa24b7139ce8db8956/Screenshot%202025-07-19%20064321.png)
*Select country for region-specific news*

![Detailed Article View](https://github.com/Shubham1919284/News_Teller/blob/20e967b33766f617bb6239fa24b7139ce8db8956/Screenshot%202025-07-19%20064548.png)
*Headline summary, sentiment & source info*

---

## 🛠️ Tech Stack

| Layer       | Tools & Libraries                                 |
|-------------|---------------------------------------------------|
| Backend     | Python, Flask                                     |
| Frontend    | HTML, CSS (Glassmorphism style), Jinja Templates  |
| NLP         | Sumy (LSA Summarizer), TextBlob                   |
| API         | [NewsAPI.org](https://newsapi.org)                |

---

## ⚙️ How to Run This Project Locally

> Make sure you have Python 3.7+ installed.
---

### 🔧 Setup

```bash
# Clone the repository
git clone https://github.com/Shubham1919284/News_Teller.git
cd News_Teller
```
---
```bash
# (Optional but recommended) Create a virtual environment
python -m venv venv
source venv/bin/activate  # For Windows: venv\Scripts\activate
```
---
```
# Install all dependencies
pip install -r requirements.txt
```
```
🔑 Add Your API Key
Sign up at newsapi.org to get your API key.
```
---
```
Create a file named config.py in the root folder of the project.
Paste this line inside the file:
NEWS_API_KEY = "your_actual_api_key_here"
```

```
🚀 Run the Flask App
python app.py
```
---
```
Then open your browser and visit:
👉 http://127.0.0.1:5000
```

---

📂 Project Structure
graphql
Copy
Edit
News_Teller/
├── app.py               # Flask app and route logic
├── index.html           # Main template for UI
├── requirements.txt     # All required Python packages
├── config.py            # Stores your NewsAPI key (you create this)
├── countries_dict.json  # Country code data for dropdown filter
└── static/              # Optional folder for images, CSS, etc.

---
📦 Dependencies
Flask
requests
textblob
sumy
nltk (for summarization tokenizer)

---
✍️ Author
Shubham Kumar Jha
🎓 B.Tech CSE (Data Science), Gulzar Group of Institutes (PTU)
📫 Email: sk1919284@gmail.com
🔗 LinkedIn
💻 GitHub

Make sure you download the required tokenizer before running the app:
python -m nltk.downloader punkt

News_Teller

News_Teller Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

News_Teller

News_Teller Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README