agentic-stock-research-system

# 📈 NSE Stock Research & Analysis System A sophisticated multi-agent AI system for analyzing Indian NSE-listed stocks using real-time data, technical indicators, news sentiment, and advanced AI reasoning. ## 🌟 Features ### 🤖 Multi-Agent Architecture - **Stock Finder Agent**: Identifies promising NSE stocks based on liquidity, market cap, and momentum - **Market Data Agent**: Gathers real-time pricing, volume, and technical indicators - **News Analyst Agent**: Analyzes recent news sentiment and market impact - **Recommendation Agent**: Provides actionable BUY/SELL/HOLD recommendations with target prices ### 📊 Advanced Analytics - Real-time NSE stock data integration - Technical indicators (RSI, Moving Averages, MACD) - Volume and volatility analysis - News sentiment classification - Risk-reward assessment ### 🎯 Smart Recommendations - Specific entry/exit price points - Stop-loss levels and risk management - Confidence scoring for each recommendation - Time horizon-based analysis (short-term to medium-term) ### 🎨 Modern UI - Clean, responsive Streamlit interface - Interactive charts and visualizations - Real-time status updates - CSV export functionality - Mobile-friendly design ## 🚀 Quick Start ### Prerequisites - Python 3.8+ - Bright Data API account ([Sign up here](https://brightdata.com)) - OpenAI API key ([Get one here](https://platform.openai.com)) ### Installation 1. **Clone the repository** ```bash git clone https://github.com/rooneyrulz/agentic-stock-research-system cd nse-stock-research-system ``` 2. **Install dependencies** ```bash pip install -r requirements.txt ``` 3. **Set up environment variables** ```bash cp .env.example .env # Edit .env with your API keys ``` 4. **Install Bright Data MCP** ```bash npm install -g @brightdata/mcp ``` ### Running the Application 1. **Start the Streamlit app** ```bash streamlit run streamlit_app.py ``` 2. **Access the application** - Open your browser to `http://localhost:8501` - Enter your API keys in the sidebar - Select analysis parameters - Click "Start Analysis" and wait for results! ## 🔧 Configuration ### API Keys Setup #### Bright Data API Token 1. Sign up at [Bright Data](https://brightdata.com) 2. Navigate to your dashboard 3. Go to "Zones" → "Web Unlocker" 4. Copy your API token #### OpenAI API Key 1. Sign up at [OpenAI Platform](https://platform.openai.com) 2. Go to "API Keys" section 3. Create a new API key 4. Copy the key (starts with 'sk-') ### Analysis Types - **Short-term Trading (1-7 days)**: Focus on momentum, technical breakouts, and news catalysts - **Medium-term Investment (1-4 weeks)**: Emphasis on earnings, sector trends, and technical setups - **General Market Analysis**: Broad market overview with top stock picks across sectors ## 📈 Sample Output ``` 🎯 TRADING RECOMMENDATIONS ═══════════════════════════════════ RELIANCE - Reliance Industries Limited ───────────────────────────────── 📋 RECOMMENDATION: BUY 🎯 TARGET PRICE: ₹2,650 ⏰ TIME HORIZON: 1-3 days 📊 CONFIDENCE: HIGH 📈 ENTRY STRATEGY: Current Price: ₹2,450 Suggested Entry: ₹2,430 - ₹2,460 Stop Loss: ₹2,380 (3.2% below entry) Target: ₹2,650 (8.2% upside potential) 💡 RATIONALE: Technical: Breakout above 50-day MA with strong volume Fundamental: Positive earnings guidance + new project announcements Risk-Reward: 1:2.6 ratio ``` ## 🏗️ System Architecture ``` ┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ │ Streamlit UI │────│ Supervisor │────│ Bright Data │ │ │ │ Agent │ │ MCP Server │ └─────────────────┘ └──────────────────┘ └─────────────────┘ │ ┌─────────┼─────────┐ │ │ │ ┌───────▼───┐ ┌───▼───┐ ┌───▼────┐ │Stock Finder│ │Market │ │News │ │ Agent │ │Data │ │Analyst │ └────────────┘ │Agent │ │Agent │ └───────┘ └────────┘ │ ┌───────▼────────┐ │ Recommendation │ │ Agent │ └────────────────┘ ``` ## 🔍 Agent Details ### Stock Finder Agent - Scans NSE universe for liquid, high-potential stocks - Filters by market cap, volume, and momentum criteria - Avoids penny stocks and illiquid securities - Focuses on large-cap and mid-cap opportunities ### Market Data Agent - Real-time price, volume, and market data - Technical indicators (RSI, MACD, Moving Averages) - Support/resistance level identification - Trend analysis and momentum assessment ### News Analyst Agent - Scrapes recent financial news and announcements - Sentiment classification (Positive/Negative/Neutral) - Impact assessment on stock prices - Catalyst identification for price movements ### Recommendation Agent - Synthesizes all data into actionable recommendations - Provides specific entry/exit strategies - Risk management and position sizing guidance - Confidence scoring and time horizon analysis ## 🛡️ Risk Management Features - **Stop-loss recommendations** for every trade suggestion - **Position sizing guidance** based on volatility - **Risk-reward ratio analysis** (minimum 1:2 ratio) - **Confidence scoring** to help with decision making - **Time horizon specification** for each recommendation ## 📊 Export & Reporting - **CSV Export**: Download analysis results for further analysis - **Interactive Charts**: Visualize current vs target prices - **Performance Tracking**: Monitor recommendation accuracy - **Historical Analysis**: Compare predictions with actual outcomes ## ⚠️ Important Disclaimers - This tool is for **educational and research purposes only** - Always consult with a qualified financial advisor before investing - Past performance does not guarantee future results - The Indian stock market involves substantial risk of loss - Do your own due diligence before making any investment decisions ## 🤝 Contributing We welcome contributions! Please see our contributing guidelines: 1. Fork the repository 2. Create a feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes (`git commit -m 'Add some amazing feature'`) 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Pull Request ## 📝 License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. ## 🆘 Support For support and questions: - Open an issue on GitHub - Check the documentation - Review the troubleshooting guide below ### Troubleshooting **Common Issues:** 1. **API Key Errors** - Ensure your Bright Data token is valid and has sufficient credits - Verify OpenAI API key starts with 'sk-' and has available quota 2. **MCP Installation Issues** ```bash # Reinstall MCP globally npm uninstall -g @brightdata/mcp npm install -g @brightdata/mcp ``` 3. **Streamlit Issues** ```bash # Clear Streamlit cache streamlit cache clear ``` 4. **Import Errors** ```bash # Reinstall dependencies pip install -r requirements.txt --force-reinstall ``` ## 🔄 Version History - **v1.0.0** - Initial release with multi-agent architecture - **v1.1.0** - Added Streamlit UI and export functionality - **v1.2.0** - Enhanced recommendation parsing and visualization --- **Made with ❤️ for the Indian Stock Market Community**