https://github.com/shortthirdman/financial-insights-agent
Hybrid Web-Enhanced Chat for Real-Time Financial Insights
https://github.com/shortthirdman/financial-insights-agent
Last synced: 14 days ago
JSON representation
Hybrid Web-Enhanced Chat for Real-Time Financial Insights
- Host: GitHub
- URL: https://github.com/shortthirdman/financial-insights-agent
- Owner: shortthirdman
- License: mit
- Created: 2026-04-21T15:09:27.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-21T17:29:32.000Z (about 2 months ago)
- Last Synced: 2026-04-21T18:31:59.843Z (about 2 months ago)
- Language: Python
- Homepage: https://financial-insights-agent.streamlit.app/
- Size: 110 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📊 Financial Insight Agent
An AI-powered stock analysis application that combines real-time market data with LLM-driven insights to deliver trend analysis, risk evaluation, and actionable investment guidance.
---
## 🚀 Overview
**Financial Insight Agent** enables users to input a stock ticker and ask natural language questions like:
- *"Is this a good time to invest?"*
- *"What is the current trend?"*
- *"What are the risks associated with this stock?"*
The application fetches live market data, computes key technical indicators, and uses a large language model to generate **human-like financial insights**.
---
## 🎯 Key Features
- 📈 **Real-time Market Data**
Fetches OHLCV data using `yfinance`
- 🧮 **Technical Indicators**
- Simple Moving Averages (SMA 20, SMA 50)
- RSI (Relative Strength Index)
- 🤖 **AI-Powered Insights**
Uses Groq-hosted LLMs (LLaMA 3) to generate:
- Trend analysis
- Risk assessment
- Buy/Hold/Sell suggestions
- 💬 **Natural Language Queries**
Ask questions in plain English
- 📊 **Interactive Visualizations**
Stock price + indicators using Plotly
---
## ✨ What This Adds
- 💬 Conversational Q&A on top of stock insights
- 🧠 Context-aware answers (uses computed indicators)
- 🔁 Chat memory within session
- ⚡ Real-time exploration (feels like an agent)
---
## 🏗️ Tech Stack
- Frontend/UI: Streamlit
- Backend Logic: Python
- LLM Provider: Groq (LLaMA 3)
- Data Source: yfinance
- Visualization: Plotly
- Orchestration: LangChain (optional extensions)
---
## 🧠 How It Works
```text
User Input (Ticker + Query)
↓
Fetch Data (yfinance)
↓
Compute Indicators
↓
Build Prompt
↓
LLM (Groq - LLaMA 3)
↓
AI Insight + Visualization
```
---
⚙️ Installation
1. Clone the Repository
```shell
git clone https://github.com/your-username/financial-insight-agent.git
cd financial-insight-agent
```
2. Install Dependencies
```shell
pip install -r requirements.txt
```
---
## 🧪 Example Usage
Enter stock ticker (e.g., AAPL, TSLA)
Ask a question:
> "Should I invest in this stock right now?"
View:
- 📈 Price chart + indicators
- 🧠 AI-generated insights
---
## 📌 Why This Project Matters
Bridges quantitative finance + AI reasoning
Demonstrates real-world GenAI application (not just chatbots)
Showcases RAG-style thinking without heavy infra
Highlights LLM + structured data synergy
---
## ⚠️ Disclaimer
This application is for educational and informational purposes only.
It does not constitute financial advice. Always do your own research before making investment decisions.
---
## 🤝 Contributing
Contributions are welcome!
Fork the repo
Create a new branch
Submit a pull request
---
## 📄 License
MIT License
---
## 👨💻 Author
Built for hackathons, learning, and real-world AI experimentation.