Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/xoxoharsh/trade-alert

Trade-Alert is a notification system that keeps users updated on critical news impacting their stock portfolios. It simplifies staying informed by delivering timely notifications for important articles, eliminating the need to monitor multiple platforms in today’s fast-paced market.
https://github.com/xoxoharsh/trade-alert

fcm-notifications firebase groq-api llm-pipeline puppeteer react-plotlyjs web-scraping

Last synced: about 20 hours ago
JSON representation

Trade-Alert is a notification system that keeps users updated on critical news impacting their stock portfolios. It simplifies staying informed by delivering timely notifications for important articles, eliminating the need to monitor multiple platforms in today’s fast-paced market.

Awesome Lists containing this project

README

        

# Trade Alert πŸ“ˆ

A real-time financial news analysis system that uses AI to provide actionable stock market insights. The system scrapes news from multiple sources, analyzes its potential impact on stocks using LLM, and sends timely notifications to users.

## 🌟 Features

- Real-time news scraping from 8 major financial news portals
- AI-powered news analysis using Groq's LLM APIs
- Automated stock impact prediction
- Real-time notifications via Firebase Cloud Messaging
- Email alerts through Nodemailer
- Responsive web interface built with MERN stack
- Docker containerization for scalable deployment

## Built after designing

[Checkout the initial figma design](https://www.figma.com/design/2vzfnx0l4Ay1ebJJy0YIMY/Red-Alert?node-id=0-1&t=sN537kqPnqVjTkzr-1)

## πŸŽ₯ Demo

[Watch the demo video](https://youtu.be/BYqgeYKpoJs)

## πŸ“Έ Screenshots of pages not in Demo

### Home Page

![Home Page](screenshots/home.png)

### Responsive Design

![Responsive Layout](screenshots/responsive.png)

### Notifications



Email Notification
Web App Notification

## πŸ—οΈ Architecture

![System Architecture](screenshots/architecture.png)

## πŸš€ Getting Started

### Prerequisites

- Node.js 16+
- MongoDB
- Docker & Docker Compose
- Firebase account
- Groq API key

### How to run the project

1. Clone the repository

```bash
git clone https://github.com/harshsharma20503/trade-alert.git
cd trade-alert
```

2. Install dependencies

```bash
# Install backend dependencies
cd backend
npm install

# Install frontend dependencies
cd ../frontend
npm install

# Install news-bots dependencies
cd ../news-bots
npm install

# Install notification-service dependencies
cd ../notification-service
npm install
```

3. Set up environment variables

- Create .env in all the folders and set the credentials as given the .env.example

4. Create a mongodb database and insert the trade-alert-companies.json data into a companies collection.

5. Get your firebase service account and save it in notification-system folder and name it as `firebase-service-account-config.json`.

6. Run the project

- See the scripts from the package.json to run the project with appropiate commands.

## πŸ‘₯ Team

- Harsh Sharma ([@harshsharma20503](https://github.com/harshsharma20503))
- Paakhi Maheshwari ([@paakhim10](https://github.com/paakhim10))
- Deepti Jain ([@deepti1028](https://github.com/deepti1028))