📰 NewsPulse AI

Your daily news, fetched, summarized, and delivered — automatically.

NewsPulse AI is a simple autonomous agent that fetches the latest news on a user's chosen topics every day, summarizes it using an LLM, and delivers a clean digest straight to their email — no manual browsing or scrolling through multiple news sites required.

---

📌 Table of Contents

• Overview
• Problem Statement
• Key Features
• Technology Stack
• System Architecture
• Project Structure
• Future Enhancements
• Project Status
• License

---

🔎 Overview

NewsPulse AI is a simple autonomous agent that fetches the latest news on a user's chosen topics every day, summarizes it using an LLM, and delivers a clean digest straight to their email — no manual browsing or scrolling through multiple news sites required.

---

🧩 Problem Statement

Staying updated on specific topics (tech, sports, finance, etc.) usually means:

Pain Point	Impact
🔄 Checking multiple news sites/apps manually every day	Wastes time
📄 Reading through long articles just to get the key point	Slows you down
📆 Easily missing a day and losing track	Breaks consistency

NewsPulse AI automates this with one agent that runs on a schedule, does the fetching and summarizing autonomously, and delivers the result without the user lifting a finger.

---

✨ Key Features

• 🎯 Topic Selection — user picks fixed interest topics at signup
• 🌐 Automated Daily News Fetching — via News API
• 🤖 AI-Powered Summarization — LLM condenses articles into a short digest
• 📧 Automated Email Delivery — scheduled daily send
• 🕘 Digest History — past digests viewable in-app

---

🛠 Technology Stack

Frontend React.js Tailwind CSS	Backend Node.js Express.js node-cron (daily scheduling)	AI Layer Gemini API (free tier) — summarization agent NewsAPI (free tier) — news source
Database MongoDB Atlas (free tier)	Email Delivery Nodemailer + Gmail SMTP (free)	Authentication JWT + bcrypt

---

🏗 System Architecture

┌─────────────────────────────┐
│   User sets topics (React)  │
└──────────────┬───────────────┘
               │
               ▼
┌─────────────────────────────┐
│  Backend API (Node/Express)  │
│   — stores user preferences  │
└──────────────┬───────────────┘
               │
               ▼
┌─────────────────────────────┐
│   Scheduled Agent (node-cron)│
│         runs daily           │
└──────────────┬───────────────┘
               │
               ▼
   News Fetch  →  LLM Summarization  →  Email Delivery
   (NewsAPI)       (Gemini)              (Nodemailer)
               │
               ▼
┌─────────────────────────────┐
│  Digest saved to MongoDB     │
│     (for history view)       │
└─────────────────────────────┘

---

📂 Project Structure

The project is organized around a single Digest Agent that runs once a day per user:

1. 📖 Reads the user's saved topics
2. 🌐 Fetches recent articles per topic
3. 🧠 Summarizes them into one digest
4. 📤 Emails the digest and saves a copy for in-app history

---

🚀 Future Enhancements

• Personalization based on read/skip history
• Multiple send times / weekly digest option
• Topic suggestions based on trending news
• WhatsApp/Telegram delivery option instead of email only

---

📊 Project Status

Planned as a beginner-friendly agentic AI project (final year).

This repository contains the following planning documents:

Document	Description
📄 1_PRD.md	Product Requirements Document
📄 2_TRD.md	Technical Requirements Document
📄 3_AppFlow.md	Application Flow
📄 4_UI-UX Brief.md	UI/UX Design Brief
📄 5_BackendSchema.md	Backend Schema Design
📄 6_ImplementationPlan.md	Implementation Plan

---

📜 License

This project is developed for educational and academic purposes.

Made with ☕ and a lot of prompt iteration.