Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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.
- Host: GitHub
- URL: https://github.com/xoxoharsh/trade-alert
- Owner: XoXoHarsh
- Created: 2024-09-14T19:45:18.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-12-29T11:31:55.000Z (20 days ago)
- Last Synced: 2025-01-16T09:10:30.461Z (2 days ago)
- Topics: fcm-notifications, firebase, groq-api, llm-pipeline, puppeteer, react-plotlyjs, web-scraping
- Language: JavaScript
- Homepage: https://youtu.be/BYqgeYKpoJs
- Size: 5.73 MB
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: news-bots/.env
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
## ποΈ 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))