Market Alert App

Market Alert App is a local Streamlit decision-support workspace for:

• stock and crypto scanning
• options-first idea ranking
• paper-trade review
• Telegram alert delivery
• background runner automation
• performance tuning and feedback loops

It is designed to help surface qualified setups, suggest cleaner ways to express them, and keep the review process visible and repeatable.

Product Snapshot

What it does today:

• scans stocks and crypto with score, relative strength, multi-timeframe, and catalyst-aware filters
• ranks stock-linked options ideas with bullish, bearish, defined-risk, and selective OTM paths
• provides an options command center, options lab, inbox, watchboard, and readiness workflow
• tracks paper trades and options idea reviews
• adapts suggestions using reviewed history, session behavior, and workflow readiness
• logs runner activity, Telegram activity, and system health

What it intentionally is not yet:

• a live brokerage execution platform
• a true chain-aware contract picker
• an auto-trading system

The current positioning is recommendation-focused and paper-workflow oriented.

Main App Areas

Scanner

• live setup qualification
• diagnostics for why setups did or did not pass
• options command center
• options-first buckets
• setup action panel for logging alerts or creating paper trades

Alert History

• follow-through review
• symbol, sector, catalyst, and tier quality summaries
• watchlist optimizer inputs

Trade Journal

• paper-trade tracking only
• open/closed trade review
• equity and daily PnL charts

Options Lab

• saved options ideas
• inbox and watchboard workflow
• readiness, drift, and review loop
• strategy / moneyness / session feedback

Telegram Log

• alert delivery audit trail

Background Runner

• runner health
• scan loop visibility
• automation commands

Scorecard

• tuning suggestions
• leaderboards
• scorecard-style performance review

Quick Start

Open the full suite with the Desktop shortcut:

• Market Alert Suite

Or launch it manually:

cd "C:\Users\Aharp\OneDrive\Desktop\market_alert_app"
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\launch_market_alert_suite.ps1

This opens:

• the Streamlit app
• the background runner

Launch Commands

Launch only the app:

cd "C:\Users\Aharp\OneDrive\Desktop\market_alert_app"
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\.venv\Scripts\Activate.ps1
python -m streamlit run app.py

Launch only the background runner:

cd "C:\Users\Aharp\OneDrive\Desktop\market_alert_app"
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\.venv\Scripts\Activate.ps1
python background_runner.py

Shutdown

Use the Desktop shortcut:

• Stop Market Alert Suite

Or run:

cd "C:\Users\Aharp\OneDrive\Desktop\market_alert_app"
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\stop_market_alert_suite.ps1

Backups

Create a timestamped backup snapshot:

cd "C:\Users\Aharp\OneDrive\Desktop\market_alert_app"
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\backup_market_alert_data.ps1

Backups are stored in:

• backups

Automatic backups:

• the background runner can create one backup automatically per day
• this behavior is controlled in the app with Automatic daily backups

Auto Start At Sign-In

The Startup-folder launcher is installed so Windows can launch the background runner at sign-in.

Install or refresh it:

.\install_startup_folder_runner.ps1

Remove it:

.\remove_startup_folder_runner.ps1

Health And Runtime Files

Background runner log:

• background_runner.log

Telegram alert log:

• telegram_alert_log.csv

Options ideas log:

• options_ideas.csv

Runner priority snapshot:

• background_priority_state.json

Runner lock file:

• background_runner.lock.json

Saved runtime config:

• runtime_settings.json

Saved Telegram settings:

• telegram_settings.json

Encrypted Telegram secrets:

• telegram_secrets.json

Common Fixes

If the app says No module named yfinance:

cd "C:\Users\Aharp\OneDrive\Desktop\market_alert_app"
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
python -m streamlit run app.py

If the runner seems duplicated or stuck:

cd "C:\Users\Aharp\OneDrive\Desktop\market_alert_app"
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\stop_market_alert_suite.ps1
Remove-Item .\background_runner.lock.json -ErrorAction SilentlyContinue
.\.venv\Scripts\Activate.ps1
python background_runner.py

If you want to inspect the runner log quickly:

Get-Content .\background_runner.log -Tail 20

Main Files

• app.py
• background_runner.py
• scanner.py
• history.py
• settings.py
• alerts.py
• launch_market_alert_suite.ps1
• stop_market_alert_suite.ps1
• backup_market_alert_data.ps1

Recommended Daily Workflow

1. Open Market Alert Suite.
2. Review the Scanner and Options Command Center.
3. Save promising ideas into Options Lab or create paper trades.
4. Let the background runner and Telegram delivery handle monitoring.
5. Review Alert History, Trade Journal, and Scorecard.
6. Close the suite with Stop Market Alert Suite when finished.