Skip to content

C0ding-Craze/Personalized-News-dashboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Personalized News Dashboard 📰

A Streamlit-powered web application that provides users with personalized news updates by integrating the NewsAPI. Search by keyword, filter by category, and stay informed with real-time news articles tailored to your interests.


Python
Streamlit
License: MIT


Features

  • 🔎 Keyword Search – Enter any keyword to fetch relevant articles (e.g., technology, sports, health).
  • 📂 Category Filtering – Choose from categories like Business, Science, Sports, Entertainment, etc.
  • 📰 Rich Display – Each article includes:
    • Title
    • Description
    • Published date
    • Image (if available)
    • Link to the full story
  • Fast & Interactive – Built with Streamlit for real-time rendering.

⚙️ Installation

  1. Clone the repository

    git clone https://github.com/C0ding-Craze/Personalized-News-dashboard.git
  2. Create and activate a virtual environment(optional)

    python -m venv venv
    source venv/bin/activate   # For Linux/Mac
    venv\Scripts\activate      # For Windows
  3. Install dependencies

    pip install streamlit
  4. Get your NewsAPI key

    • Sign up at NewsAPI.org
    • Copy your API key
    • Replace "Your Api key" in the code with your key

Usage

Run the Streamlit app:

streamlit run main.py

🤝 Contributing

Contributions are welcome! 🎉

  1. Fork the repo
  2. Create a new branch (git checkout -b feature-name)
  3. Commit your changes (git commit -m "Added new feature")
  4. Push to the branch (git push origin feature-name)
  5. Open a Pull Request

📜 License

This project is licensed under the MIT License – see the LICENSE file for details.


Contact

Author: Abdul-Rehman
GitHub: C0ding-Craze

About

A Streamlit-powered web app that fetches and displays real-time articles from the NewsAPI, allowing users to search by keyword, filter by category, and explore personalized news feeds.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages