From 7ede4a5cd3fcfa2c4b6f054d483c80d8048b2a12 Mon Sep 17 00:00:00 2001
From: "swj.premkumar" <swj.premkumar@gmail.com>
Date: Wed, 14 Jan 2026 07:30:07 -0600
Subject: [PATCH] ## Real-Time Notifications

TradingAgents can send instant BUY/SELL/HOLD signals to your phone via WhatsApp or Telegram.
---
 CHANGELOG.md |  5 +++++
 README.md    | 17 +++++++++++++++++
 2 files changed, 22 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 15a44b0f..735ca9cb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -46,6 +46,11 @@ All notable changes to the **TradingAgents** project will be documented in this
 - **Strict State Schemas (Type Safety)**: Defined `SocialAnalystState`, `NewsAnalystState`, and `FundamentalsAnalystState` in `agent_states.py`.
     - Restricts analyst subgraphs to only access necessary inputs (`company`, `date`) and write specific outputs (`report`).
     - Eliminates "global state leakage" risks.
+- **Universal Notification System**: Implemented a unified factory pattern (`get_notifier`) in `notifications.py` supporting:
+    - **CallMeBot**: Free WhatsApp notifications (Personal Use).
+    - **Telegram**: Free Bot API notifications (Reliable Alternative).
+    - **Twilio**: Enterprise-grade WhatsApp notifications.
+    - Zero-dependency implementation (using `requests`).
 
 ### Fixed
 - **Concurrent Write Conflict**: Resolved `InvalidUpdateError` in LangGraph during parallel "Fan-In".
diff --git a/README.md b/README.md
index b9b060a5..95775c58 100644
--- a/README.md
+++ b/README.md
@@ -275,6 +275,23 @@ print(decision)
 
 You can view the full list of configurations in `tradingagents/default_config.py`.
 
+## Real-Time Notifications
+
+TradingAgents can send instant BUY/SELL/HOLD signals to your phone via WhatsApp or Telegram.
+
+**Supported Providers:**
+1.  **CallMeBot (WhatsApp)**: Free, perfect for personal use.
+2.  **Telegram**: Free, reliable, recommended for most users.
+3.  **Twilio (WhatsApp)**: Enterprise-grade, paid.
+
+**Usage:**
+Simply set the `NOTIFICATION_PROVIDER` in your `.env` file (see `.env.example` for keys).
+```bash
+NOTIFICATION_PROVIDER=telegram
+TELEGRAM_BOT_TOKEN=...
+TELEGRAM_CHAT_ID=...
+```
+
 ## Contributing
 
 We welcome contributions from the community! Whether it's fixing a bug, improving documentation, or suggesting a new feature, your input helps make this project better. If you are interested in this line of research, please consider joining our open-source financial AI research community [Tauric Research](https://tauric.ai/).