{"id":30111113,"url":"https://github.com/rooneyrulz/agentic-stock-research-system","last_synced_at":"2026-04-13T06:42:25.162Z","repository":{"id":308735090,"uuid":"1033902148","full_name":"rooneyrulz/agentic-stock-research-system","owner":"rooneyrulz","description":"A sophisticated multi-agent AI system for analyzing Indian NSE-listed stocks using real-time data, technical indicators, news sentiment, and advanced AI reasoning.","archived":false,"fork":false,"pushed_at":"2025-08-07T15:48:13.000Z","size":96,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-07T16:24:32.307Z","etag":null,"topics":["ai-agents","groq","langchain","langgraph","llms","mcp","openai","python","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rooneyrulz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-07T14:21:10.000Z","updated_at":"2025-08-07T15:56:36.000Z","dependencies_parsed_at":"2025-08-07T16:26:41.990Z","dependency_job_id":"bb05d5b0-003f-4f38-ac2a-61b9274e4318","html_url":"https://github.com/rooneyrulz/agentic-stock-research-system","commit_stats":null,"previous_names":["rooneyrulz/agentic-stock-research-system"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/rooneyrulz/agentic-stock-research-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rooneyrulz%2Fagentic-stock-research-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rooneyrulz%2Fagentic-stock-research-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rooneyrulz%2Fagentic-stock-research-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rooneyrulz%2Fagentic-stock-research-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rooneyrulz","download_url":"https://codeload.github.com/rooneyrulz/agentic-stock-research-system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rooneyrulz%2Fagentic-stock-research-system/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269677801,"owners_count":24457876,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-10T02:00:08.965Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","groq","langchain","langgraph","llms","mcp","openai","python","streamlit"],"created_at":"2025-08-10T05:07:30.452Z","updated_at":"2025-10-19T08:47:44.492Z","avatar_url":"https://github.com/rooneyrulz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📈 NSE Stock Research \u0026 Analysis System\n\nA sophisticated multi-agent AI system for analyzing Indian NSE-listed stocks using real-time data, technical indicators, news sentiment, and advanced AI reasoning.\n\n## 🌟 Features\n\n### 🤖 Multi-Agent Architecture\n- **Stock Finder Agent**: Identifies promising NSE stocks based on liquidity, market cap, and momentum\n- **Market Data Agent**: Gathers real-time pricing, volume, and technical indicators  \n- **News Analyst Agent**: Analyzes recent news sentiment and market impact\n- **Recommendation Agent**: Provides actionable BUY/SELL/HOLD recommendations with target prices\n\n### 📊 Advanced Analytics\n- Real-time NSE stock data integration\n- Technical indicators (RSI, Moving Averages, MACD)\n- Volume and volatility analysis\n- News sentiment classification\n- Risk-reward assessment\n\n### 🎯 Smart Recommendations\n- Specific entry/exit price points\n- Stop-loss levels and risk management\n- Confidence scoring for each recommendation\n- Time horizon-based analysis (short-term to medium-term)\n\n### 🎨 Modern UI\n- Clean, responsive Streamlit interface\n- Interactive charts and visualizations\n- Real-time status updates\n- CSV export functionality\n- Mobile-friendly design\n\n## 🚀 Quick Start\n\n### Prerequisites\n- Python 3.8+\n- Bright Data API account ([Sign up here](https://brightdata.com))\n- OpenAI API key ([Get one here](https://platform.openai.com))\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/rooneyrulz/agentic-stock-research-system\n   cd nse-stock-research-system\n   ```\n\n2. **Install dependencies**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **Set up environment variables**\n   ```bash\n   cp .env.example .env\n   # Edit .env with your API keys\n   ```\n\n4. **Install Bright Data MCP**\n   ```bash\n   npm install -g @brightdata/mcp\n   ```\n\n### Running the Application\n\n1. **Start the Streamlit app**\n   ```bash\n   streamlit run streamlit_app.py\n   ```\n\n2. **Access the application**\n   - Open your browser to `http://localhost:8501`\n   - Enter your API keys in the sidebar\n   - Select analysis parameters\n   - Click \"Start Analysis\" and wait for results!\n\n## 🔧 Configuration\n\n### API Keys Setup\n\n#### Bright Data API Token\n1. Sign up at [Bright Data](https://brightdata.com)\n2. Navigate to your dashboard\n3. Go to \"Zones\" → \"Web Unlocker\" \n4. Copy your API token\n\n#### OpenAI API Key\n1. Sign up at [OpenAI Platform](https://platform.openai.com)\n2. Go to \"API Keys\" section\n3. Create a new API key\n4. Copy the key (starts with 'sk-')\n\n### Analysis Types\n\n- **Short-term Trading (1-7 days)**: Focus on momentum, technical breakouts, and news catalysts\n- **Medium-term Investment (1-4 weeks)**: Emphasis on earnings, sector trends, and technical setups  \n- **General Market Analysis**: Broad market overview with top stock picks across sectors\n\n## 📈 Sample Output\n\n```\n🎯 TRADING RECOMMENDATIONS\n═══════════════════════════════════\n\nRELIANCE - Reliance Industries Limited\n─────────────────────────────────\n📋 RECOMMENDATION: BUY\n🎯 TARGET PRICE: ₹2,650\n⏰ TIME HORIZON: 1-3 days\n📊 CONFIDENCE: HIGH\n\n📈 ENTRY STRATEGY:\nCurrent Price: ₹2,450\nSuggested Entry: ₹2,430 - ₹2,460\nStop Loss: ₹2,380 (3.2% below entry)\nTarget: ₹2,650 (8.2% upside potential)\n\n💡 RATIONALE:\nTechnical: Breakout above 50-day MA with strong volume\nFundamental: Positive earnings guidance + new project announcements\nRisk-Reward: 1:2.6 ratio\n```\n\n## 🏗️ System Architecture\n\n```\n┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐\n│   Streamlit UI  │────│   Supervisor     │────│  Bright Data    │\n│                 │    │     Agent        │    │   MCP Server    │\n└─────────────────┘    └──────────────────┘    └─────────────────┘\n                              │\n                    ┌─────────┼─────────┐\n                    │         │         │\n            ┌───────▼───┐ ┌───▼───┐ ┌───▼────┐\n            │Stock Finder│ │Market │ │News    │\n            │   Agent    │ │Data   │ │Analyst │\n            └────────────┘ │Agent  │ │Agent   │\n                          └───────┘ └────────┘\n                                │\n                        ┌───────▼────────┐\n                        │ Recommendation │\n                        │     Agent      │\n                        └────────────────┘\n```\n\n## 🔍 Agent Details\n\n### Stock Finder Agent\n- Scans NSE universe for liquid, high-potential stocks\n- Filters by market cap, volume, and momentum criteria\n- Avoids penny stocks and illiquid securities\n- Focuses on large-cap and mid-cap opportunities\n\n### Market Data Agent  \n- Real-time price, volume, and market data\n- Technical indicators (RSI, MACD, Moving Averages)\n- Support/resistance level identification\n- Trend analysis and momentum assessment\n\n### News Analyst Agent\n- Scrapes recent financial news and announcements\n- Sentiment classification (Positive/Negative/Neutral)\n- Impact assessment on stock prices\n- Catalyst identification for price movements\n\n### Recommendation Agent\n- Synthesizes all data into actionable recommendations\n- Provides specific entry/exit strategies\n- Risk management and position sizing guidance\n- Confidence scoring and time horizon analysis\n\n## 🛡️ Risk Management Features\n\n- **Stop-loss recommendations** for every trade suggestion\n- **Position sizing guidance** based on volatility\n- **Risk-reward ratio analysis** (minimum 1:2 ratio)\n- **Confidence scoring** to help with decision making\n- **Time horizon specification** for each recommendation\n\n## 📊 Export \u0026 Reporting\n\n- **CSV Export**: Download analysis results for further analysis\n- **Interactive Charts**: Visualize current vs target prices\n- **Performance Tracking**: Monitor recommendation accuracy\n- **Historical Analysis**: Compare predictions with actual outcomes\n\n## ⚠️ Important Disclaimers\n\n- This tool is for **educational and research purposes only**\n- Always consult with a qualified financial advisor before investing\n- Past performance does not guarantee future results\n- The Indian stock market involves substantial risk of loss\n- Do your own due diligence before making any investment decisions\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our contributing guidelines:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🆘 Support\n\nFor support and questions:\n- Open an issue on GitHub\n- Check the documentation\n- Review the troubleshooting guide below\n\n### Troubleshooting\n\n**Common Issues:**\n\n1. **API Key Errors**\n   - Ensure your Bright Data token is valid and has sufficient credits\n   - Verify OpenAI API key starts with 'sk-' and has available quota\n\n2. **MCP Installation Issues**\n   ```bash\n   # Reinstall MCP globally\n   npm uninstall -g @brightdata/mcp\n   npm install -g @brightdata/mcp\n   ```\n\n3. **Streamlit Issues**\n   ```bash\n   # Clear Streamlit cache\n   streamlit cache clear\n   ```\n\n4. **Import Errors**\n   ```bash\n   # Reinstall dependencies\n   pip install -r requirements.txt --force-reinstall\n   ```\n\n## 🔄 Version History\n\n- **v1.0.0** - Initial release with multi-agent architecture\n- **v1.1.0** - Added Streamlit UI and export functionality  \n- **v1.2.0** - Enhanced recommendation parsing and visualization\n\n---\n\n**Made with ❤️ for the Indian Stock Market Community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frooneyrulz%2Fagentic-stock-research-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frooneyrulz%2Fagentic-stock-research-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frooneyrulz%2Fagentic-stock-research-system/lists"}