{"id":30303845,"url":"https://github.com/sayed-ashfaq/stocksnapai","last_synced_at":"2025-10-04T18:17:21.405Z","repository":{"id":309167994,"uuid":"1035341761","full_name":"sayed-ashfaq/StockSnapAI","owner":"sayed-ashfaq","description":"RAG app that helps to analyze the stock, news, kpi's and reports","archived":false,"fork":false,"pushed_at":"2025-08-10T08:37:58.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-10T10:14:23.148Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","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/sayed-ashfaq.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-10T07:25:44.000Z","updated_at":"2025-08-10T08:38:01.000Z","dependencies_parsed_at":"2025-08-10T10:14:32.076Z","dependency_job_id":null,"html_url":"https://github.com/sayed-ashfaq/StockSnapAI","commit_stats":null,"previous_names":["sayed-ashfaq/stocksnapai"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/sayed-ashfaq/StockSnapAI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayed-ashfaq%2FStockSnapAI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayed-ashfaq%2FStockSnapAI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayed-ashfaq%2FStockSnapAI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayed-ashfaq%2FStockSnapAI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sayed-ashfaq","download_url":"https://codeload.github.com/sayed-ashfaq/StockSnapAI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayed-ashfaq%2FStockSnapAI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270816061,"owners_count":24650748,"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-17T02:00:09.016Z","response_time":129,"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":[],"created_at":"2025-08-17T06:34:18.840Z","updated_at":"2025-10-04T18:17:21.369Z","avatar_url":"https://github.com/sayed-ashfaq.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n---\n\n# 🤖 AI Finance Copilot (Prototype)\n\n\u003e ⚠️ **Prototype App** – This project is an experimental build to test and validate the idea of an AI-powered finance assistant.\n\u003e 🚀 A full **industry-grade web application** is planned for future development.\n\nAI Finance Copilot is a **Streamlit-based prototype** that assists traders and analysts with **stock sentiment analysis** and **financial document insights**. It combines real-time market intelligence with AI-powered document analysis to demonstrate what a next-generation financial research tool could look like.\n\n---\n\n## ✨ Features\n\n### 📈 Stock News \u0026 Sentiment Analysis\n\n* Add multiple stocks to a custom portfolio\n* Get **real-time news analysis** with AI sentiment scoring\n* Portfolio-level insights: themes, risks, opportunities\n* Individual stock summaries with sentiment impact\n* Portfolio distribution charts (bullish, bearish, neutral)\n\n### 📄 Document Chat \u0026 Analysis\n\n* Upload financial documents (earnings, annual reports, etc.)\n* AI-powered summaries with **red flag detection**\n* Chat with documents using natural language (with citations)\n* Quick questions for faster insights\n* Export chat history\n\n---\n## 📊 Dashboard\n\n#### Link: https://stocksnapai.streamlit.app/\n\n## 🖼️ Screenshots\n\n### Home \u0026 API Configuration\n\n\u003cimg width=\"300\" height=\"289\" alt=\"Screenshot 2025-09-01 122910\" src=\"https://github.com/user-attachments/assets/0be481f8-9bfb-41ce-82c8-46e0853f51ca\" /\u003e\n\n### Stock News \u0026 Portfolio Analysis\n\n\u003cimg width=\"413\" height=\"500\" alt=\"StockSnapAI-1\" src=\"https://github.com/user-attachments/assets/a9caefda-6a56-43ff-8667-50a012ae1e26\" /\u003e\n\n### Document Upload \u0026 Summaries\n\n\u003cimg width=\"413\" height=\"500\" alt=\"StockSnapAI-2\" src=\"https://github.com/user-attachments/assets/07943934-3755-4db3-b8b3-400279f31c31\" /\u003e\n\n### Interactive Document Q\\\u0026A\n\n\u003cimg width=\"413\" height=\"409\" alt=\"StocksnapAI-3\" src=\"https://github.com/user-attachments/assets/aba73a30-f0a4-4f41-adff-00320154b881\" /\u003e\n\n\n---\n\n## 🚀 Getting Started\n\n### 1. Clone Repository\n\n```bash\ngit clone https://github.com/sayed-ashfaq/StockSnapAI\ncd StockSnapAI\n```\n\n### 2. Install Dependencies\n\n```bash\npip install -r requirements.txt\n```\n\n### 3. API Keys (Free Tiers Available)\n\n* [OpenAI](https://platform.openai.com/api-keys) – embeddings \u0026 analysis\n* [Google AI](https://makersuite.google.com/app/apikey) – Gemini model\n* [Tavily](https://app.tavily.com/) – real-time news search\n\nEnter keys in the **sidebar** after starting the app.\n\n### 4. Run the App\n\n```bash\nstreamlit run main.py\n```\n\n---\n\n## 🛠️ Tech Stack\n\n* **Streamlit** – Web interface\n* **LangChain + LangGraph** – AI orchestration\n* **OpenAI Embeddings** – Document vectorization\n* **Google Gemini 2.0** – LLM for chat \u0026 analysis\n* **Tavily Search** – Real-time financial news\n\n---\n\n## 📂 Project Structure\n\n```\nai-finance-copilot/\n├── main.py                 # Streamlit app entry point\n├── requirements.txt        # Dependencies\n└── modules/\n    ├── stock_analyzer.py   # Stock sentiment logic\n    └── document_chat.py    # Document RAG + Q\u0026A\n└──...\n└──...\n```\n\n---\n\n## ⚠️ Prototype Limitations\n\n* Basic UI/UX\n* No persistent data storage\n* Limited error handling\n* Session-based API key storage\n* Charts \u0026 analytics are minimal\n\n---\n\n## 🔮 Roadmap (Industry-Grade Version)\n\nPlanned features for the full-scale application:\n\n* Advanced dashboards \u0026 visualizations\n* Persistent storage (DB-backed portfolio \u0026 documents)\n* Real-time alerts \u0026 monitoring\n* Multi-user support with authentication\n* Enhanced security for sensitive documents\n* Web based app\n* Exception handing and custom logging\n* Advanced vectorstore chunking, retriving methods\n\n---\n\n## 📞 Contact\n\nFor collaboration or updates on the full version:\n\n* **Email**: [302syedashfaq@gmail.com](mailto:302syedashfaq@gmai.com)\n* **LinkedIn**: [sayed-ashfaq](https://www.linkedin.com/in/sayed-ashfaq/)\n\n---\n\n⚖️ **Disclaimer**: This prototype is for demonstration purposes only. It does not provide financial advice.\n\n⭐ Star the repo if you find this project interesting!\n\n---\n\n## Notes\n\n### 📊 Vector DBs Comparison for RAG Apps (2025)\n\n| Feature / DB                        | **Chroma** 🟢                 | **FAISS** 🟠                       | **Pinecone** 🔵                   | **Weaviate** 🟣              | **Milvus** 🔴              | **Qdrant** 🟤                           |\n| ----------------------------------- | ----------------------------- | ---------------------------------- | --------------------------------- | ---------------------------- | -------------------------- | --------------------------------------- |\n| **Type**                            | Local DB                      | Library (ANN)                      | Managed Cloud DB                  | Hybrid (self-host + cloud)   | Open-source DB             | Open-source DB                          |\n| **Persistence**                     | ✅ Yes                         | ❌ Manual                           | ✅ Yes                             | ✅ Yes                        | ✅ Yes                      | ✅ Yes                                   |\n| **Metadata filtering**              | ✅ Yes                         | ❌ No                               | ✅ Yes                             | ✅ Yes                        | ✅ Yes                      | ✅ Yes                                   |\n| **Multimodal support** (text+image) | ⚠️ Limited (custom)           | ❌ No                               | ✅ Yes (new multimodal support)    | ✅ Yes (via modules)          | ✅ Yes (via plugins)        | ✅ Yes (via payload)                     |\n| **Scalability**                     | ⚠️ Small–medium (10k–1M docs) | ✅ Billions (single machine)        | ✅ Billions (distributed)          | ✅ Billions (distributed)     | ✅ Billions (distributed)   | ✅ 100M+ (distributed)                   |\n| **Cloud-managed option**            | ❌ No                          | ❌ No                               | ✅ Yes                             | ✅ Yes (Weaviate Cloud)       | ✅ (Zilliz Cloud)           | ✅ (Qdrant Cloud)                        |\n| **Self-hosting**                    | ✅ Yes (simple)                | ✅ Yes                              | ❌ Cloud only                      | ✅ Yes                        | ✅ Yes                      | ✅ Yes                                   |\n| **Ease of use**                     | ⭐⭐⭐⭐                          | ⭐⭐                                 | ⭐⭐⭐⭐                              | ⭐⭐⭐                          | ⭐⭐⭐                        | ⭐⭐⭐⭐                                    |\n| **Community/Docs**                  | Medium                        | High (researchers)                 | Very High (enterprise)            | High                         | High                       | Growing fast                            |\n| **Best for**                        | Prototypes, small RAG apps    | Hardcore performance, custom infra | Production SaaS, enterprise scale | Enterprise + semantic search | Open-source, huge datasets | Mid-scale open-source, Rust-based speed |\n\n---\n\n#### ⚡ For Your Case (News + Financial Reports + Images in India)\n\n* Start with **Chroma** → simple, fast iteration.\n* If you **need multimodal embeddings (text + image)**:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsayed-ashfaq%2Fstocksnapai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsayed-ashfaq%2Fstocksnapai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsayed-ashfaq%2Fstocksnapai/lists"}