इस प्रोजेक्ट के बारे में

Watchy एक सेल्फ-होस्टेड स्टॉक-मॉनिटरिंग डेमन है जो TradingAgents मल्टी-एजेंट LLM ट्रेडिंग फ्रेमवर्क पर बना है। यह उपयोगकर्ता-निर्धारित वॉचलिस्ट को देखता है और Telegram पर पोज़िशन-अवेयर गाइडेंस भेजता है। यह स्पष्ट रूप से एक निर्णय-सहायता प्रणाली है: यह कभी ऑर्डर नहीं देता और रिटर्न की भविष्यवाणी या अल्फा उत्पन्न करने का दावा नहीं करता। दो-स्तरीय डिज़ाइन। Tier 1 एक शून्य-लागत तकनीकी स्कैन है (डिफ़ॉल्ट रूप से हर 30 मिनट, केवल US नियमित ट्रेडिंग घंटों में, exchange_calendars के माध्यम से DST-सही) जो yfinance के ज़रिए OHLCV प्राप्त करता है और बिना किसी LLM कॉल के संकेतकों की गणना करता है। यह 11 सिग्नल प्रकारों का पता लगाता है, जिनमें मूविंग-एवरेज स्टेयरकेस पुष्टि के साथ गोल्डन/डेथ क्रॉस, RSI चरम, MACD क्रॉसओवर, बोलिंजर बैंड उल्लंघन, वॉल्यूम विसंगतियाँ और ATR स्पाइक शामिल हैं। Tier 2 पूर्ण चार-विश्लेषक TradingAgents पाइपलाइन (Market, Sentiment, News, Fundamentals) को Bull/Bear डिबेट और जोखिम प्रबंधन के साथ चलाता है, जिसकी गहराई प्रत्येक सप्ताह के पहले ट्रेडिंग दिन पर पूर्ण तीन-तरफ़ा जोखिम डिबेट तक बढ़ जाती है। Watchy 2.0 (v2.0.0-rc.1) साप्ताहिक प्लान और इवेंट-ड्रिवन मॉनिटरिंग की ओर बढ़ता है। साप्ताहिक पूर्ण रन सलाहकार से एक सख्त WEEKLY PLAN ब्लॉक माँगता है (निर्णय, तात्कालिकता, थीसिस, बाय ज़ोन, चेस सीलिंग, अमान्यता स्तर/शर्त, ट्रिम शर्त, प्रतिरोध, टेक-प्रॉफ़िट मूल्य, गाइडेंस, और एक ठोस "do not")। सक्रियण से पहले प्लानों को मान्य किया जाता है; अमान्य आउटपुट निदान के लिए संग्रहीत किया जाता है और कभी कार्रवाई योग्य नहीं बनता। प्रत्येक स्कैन प्लान के विरुद्ध मूल्य को वर्गीकृत करता है और केवल स्थिति परिवर्तनों पर सूचित करता है, जिसे इस तरह सहेजा जाता है कि पुनःआरंभ होने पर अलर्ट दोहराए न जाएँ। एक शुद्ध राउटर ट्रिगर्स को TAKE_PROFIT, TRIGGERED_RISK, FAST_RECHECK, NOTIFY_ONLY या NO_ACTION में से एक पर मैप करता है, जिसमें शैडो मोड (शिप किया गया डिफ़ॉल्ट), टिकर के allow-list में न होने, या प्रति-टिकर/वैश्विक सत्र बजट खर्च होने पर सशुल्क रूट को रिमाइंडर में डाउनग्रेड किया जाता है। नियतात्मक स्टेटस लेबल (ACT NOW, WAIT FOR LIMIT, DO NOT CHASE, RISK REVIEW, PLAN INVALID, STALE, INFORMATION ONLY) को LLM द्वारा ओवरराइड नहीं किया जा सकता। tier2_schedule: daily सेट करने पर 1.x व्यवहार बहाल हो जाता है। अन्य प्रलेखित विशेषताएँ: एक प्राइस-प्रॉक्सिमिटी गेट जो watch-only टिकर्स के लिए उनके एंट्री लक्ष्य से दूर होने पर महँगे विश्लेषण को छोड़ देता है जबकि होल्ड की गई पोज़िशनों का हमेशा विश्लेषण करता है; एक कैलिब्रेशन स्क्रिप्ट के साथ वैकल्पिक ATR-अनुकूली बैंड; एक टेक-प्रॉफ़िट / एंटी-राउंड-ट्रिप पथ जो गेन फ़्लोर पार कर चुके होल्ड किए गए विजेताओं के लिए तथ्यों से भरा निर्देश इंजेक्ट करता है और शेयर संख्या के अनुसार प्रस्तावों को अनुकूलित करता है (पूर्ण-शेयर ट्रांच, पूर्ण निकास, फ्रैक्शनल मार्केट ट्रिम); एक स्तरित पोज़िशन स्रोत (Schwab API लाइव, कैश्ड स्नैपशॉट, मैनुअल YAML) जिसमें आयु लेबलिंग और टोकन-समाप्ति अलर्ट हैं; और journal लाइनों, एक route_log तालिका, तथा status, plan निरीक्षण, dry routing/preview, बाध्य साप्ताहिक रन और एक read-only routing replay के लिए scripts/watchy_ctl.py कमांडों के माध्यम से observability। तैनाती systemd के माध्यम से होती है, जिसमें कॉन्फ़िग एक कमिट करने योग्य config.yaml और एक git-ignored secrets.yaml के बीच विभाजित होता है। Python 3.11+, MIT लाइसेंस।