📈 Stock Alert Automation

A cloud-based, serverless stock monitoring system built with GitHub Actions and Python.
It runs automatically on a regular schedule and sends an e-mail alert when a stock price hits a target.

⚙️ How it works

• Executes on a scheduled GitHub Actions workflow (weekday schedule: 2pm EST)
• Fetches live stock data using yfinance
• Evaluates custom price targets securely stored in GitHub Secrets
• Sends e-mail alerts via Gmail SMTP
• No server management required (fully serverless execution on GitHub infrastructure)

🧩 Architecture

  GitHub Actions (cron)
          ↓
  Python Script
          ↓
  yfinance API
          ↓
  Rule Engine (threshold check)
          ↓
  SMTP Email Alert
    

🔐 Security

• All secrets stored in GitHub Secrets
• No hardcoded API keys or credentials
• Isolated execution per workflow run

🚀 Tech Stack

• Python 3.11
• GitHub Actions
• yfinance module
• SMTP (Gmail App Password)

📊 Status

🟢 Active — running on GitHub Actions (weekdays)

📊 Example of a triggered stock alert

An automated e-mail generated when a stock hits the defined target price.