Nuanced News

Nuanced News is a web application that curates current news stories from various sources across the web. It highlights left-leaning and right-leaning bias and enables readers to gain a comprehensive and balanced understanding of the WHOLE story.

NN is open to contributors! Please star the repository if this interests you!

Features

• User Authentication
• News Aggregation
• Real-time updates

How it Works

Large news publications post their .rss files, which are XML files that contain the latest news articles from the publication. The Nuanced News app fetches these .rss files from various sources, parses the XML to extract article information, and categorizes the articles based on their source's political bias.

Technologies Used

• Frontend:

• React
• Bootstrap
• Vite
• Axios

• Backend:

• Flask
• Python

• Other:

• Firebase (User Auth)

Installation and Setup

1. Clone the repository

git clone https://github.com/jackabald/NuancedNews.git
cd NuancedNews

2. Backend Setup

• Navigate to the backend directory and setup a virtual environment:

  cd Backend
  python -m venv venv
  source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

• Install the required Python packages:

  pip install -r requirements.txt

• Parse RSS feeds and start the Flask server:

  python rss_parser.py
  python app.py

  3. Frontend Setup

• Navigate to the frontend directory:

  cd Frontend

• Install required node packages:

  npm install

• Create a .env file in the frontend directory to hold all of your environment variables for Firebase Web SDK:

  VITE_API_KEY=your_firebase_api_key
  VITE_AUTH_DOMAIN=your_firebase_auth_domain
  VITE_PROJECT_ID=your_firebase_project_id
  VITE_STORAGE_BUCKET=your_firebase_storage_bucket
  VITE_MESSAGING_SENDER_ID=your_firebase_messaging_sender_id
  VITE_APP_ID=your_firebase_app_id

• Start development server:

  npm run dev