Skip to content

Neongenesis-Dev/FeedMind

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 FeedMind — AI-Powered News Aggregator

"An AI that curates what your mind wants to read."

Good First Issues Help Wanted Contributors Welcome

FeedMind is an open-source AI-driven news aggregator that collects news from multiple sources, analyzes sentiment, detects bias, and intelligently classifies articles by topic — giving users a personalized, balanced, and engaging reading experience.


📰 Project Overview

FeedMind aims to redefine how people consume news using the power of Artificial Intelligence and Natural Language Processing (NLP).

Instead of scrolling endlessly, FeedMind curates what truly matters — automatically categorizing articles, analyzing tone, and highlighting trending topics with visual insights.


⚙️ Core Features

  • 🧠 AI-Powered Curation — Aggregates and classifies news based on content, category, and keywords.
  • 💬 Sentiment Analysis — Understands the tone (positive, negative, neutral) of each article.
  • 🎭 Bias Detection (Add-on) — Measures potential bias in the writing using NLP indicators.
  • 🔍 Smart Filtering — Filter by topic, sentiment, or publication.
  • 📰 Multi-Source Aggregation — Pulls data from verified APIs and open news platforms.
  • 📊 Trend Visualizations — Displays trending topics and sentiment graphs for better insights.
  • 🧾 Fake News Detection (Add-on) — Uses trained ML models to flag unreliable content.
  • 🌐 Responsive Web UI — Clean, modern, and mobile-friendly interface.

🧩 Tech Stack

Layer Technology
Frontend React.js / Next.js, TailwindCSS
Backend Node.js / Express.js
Database MongoDB / Firebase
AI / NLP Python (Transformers, NLTK, spaCy, Hugging Face Models)
APIs NewsAPI / GDELT / Custom Web Scraper
Visualization Chart.js / Recharts / D3.js
Deployment Vercel / Render / Hugging Face Spaces

🧠 System Architecture

User → Frontend UI → Backend API → AI/NLP Engine → Database → Visualization Dashboard

  • Backend fetches data from news APIs.
  • NLP Engine classifies and analyzes articles.
  • Frontend displays categorized, sentiment-tagged news.
  • Visualization Dashboard shows analytics and trends.

👥 Team Roles

Role Responsibility
🧠 NLP Developer Build models for topic classification, sentiment & bias detection.
💾 Backend Developer Create API endpoints, integrate external news sources, manage DB.
🌐 Frontend Developer Design interactive UI for browsing and filtering news.
📊 Data Analyst Develop visualization dashboards and analytics modules.

🚀 Quick Start

1️⃣ Clone the Repository

git clone https://github.com/<your-username>/FeedMind.git
cd FeedMind

2️⃣ Backend Setup

cd backend
npm install
npm start

3️⃣ Frontend Setup

cd frontend
npm install
npm run dev

4️⃣ (Optional) Run AI Server

cd ai-engine
pip install -r requirements.txt
python app.py

5️⃣ Open in Browser

Visit 👉 http://localhost:3000

📈 Future Enhancements

  • 🧾 Real-time fake news detection.
  • 🔊 Voice-based news summarization.
  • 🌍 Multi-language news translation.
  • 🔔 Personalized daily news digest via email or notification.
  • 🤝 Chrome extension or mobile app integration.

🤝 Contributing

We welcome contributions from developers of all skill levels! Whether you're a beginner or experienced developer, there's a place for you in the FeedMind community.

🌟 For New Contributors

Getting Started:

  1. 📖 Read our Contributing Guide
  2. 🌟 Check out Good First Issues
  3. 💬 Join discussions in our issues
  4. 🚀 Start with documentation, testing, or small features

Perfect First Contributions:

  • 📝 Documentation improvements
  • 🎨 UI/UX enhancements
  • 🧪 Writing tests
  • 🔧 Setting up project infrastructure
  • 🌐 Frontend components
  • 🔗 API endpoints

🔄 Standard Workflow

  1. 🍴 Fork this repo
  2. 🌿 Create your feature branch: git checkout -b feature/your-feature
  3. 💾 Commit your changes: git commit -m "feat: add new feature"
  4. 📤 Push to branch: git push origin feature/your-feature
  5. 🔁 Open a Pull Request with detailed description

📋 Before Contributing

  • Check existing issues and PRs to avoid duplicates
  • Comment on issues you'd like to work on
  • Follow our coding standards and conventions
  • Write tests for new features
  • Update documentation as needed

Need help? Don't hesitate to ask questions in issue comments!

✨ Team FeedMind

Name Role GitHub
Nitesh Dipak Badgujar AI/ML Developer @Nitesh-Badgujar
Member 2 Frontend Developer
Member 3 Backend Developer
Member 4 Data Analyst

💬 Tagline

🧠 "FeedMind — AI that curates what your mind wants to read."

🌟 Project Status

Stage: Initialization
Goal: Build 40% of the MVP in the first phase (news aggregation, topic classification, sentiment visualization).


About

The future of news, tailored to your thinking.

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors