How akhiil-626/investiq works
InvestIQ is an educational Flask app that compares Reddit sentiment with recent stock-price movement. A user submits a ticker; the route fetches price data, selects real Reddit sentiment or deterministic mock scores, normalizes both measures, classifies their divergence, and renders a results page with an educational explanation. Price retrieval, sentiment collection, scoring, and summarization are distinct runtime stages. The README also describes optional Reddit credentials and Grok summaries. The graph follows the sampled route and module calls; unsampled template behavior is not inferred.
Main entry points: app.py Flask routes · price_fetcher.py Price retrieval · reddit_sentiment.py Reddit sentiment · ai_summary.py Educational summary
Components 12
Web experience
- Flask routes
app.py - Ticker form
templates/index.html - Results view
templates/results.html
Divergence analysis
- Scoring engine
scoring_engine.py
Data and explanation
- Price retrieval
data/price_fetcher.py - Reddit sentiment
data/reddit_sentiment.py - Mock sentiment
data/reddit_sentiment.py - Educational summary
data/ai_summary.py
Other components
- User
- Yahoo Finance
- Grok API
Connections 11
- User → Flask routes: submits ticker
app.py - Flask routes → Ticker form: renders
app.py - Flask routes → Price retrieval: fetches prices
app.py - Price retrieval → Yahoo Finance: requests history
data/price_fetcher.py - Flask routes → Reddit sentiment: tries collection
app.py - Reddit sentiment → Reddit: searches posts
data/reddit_sentiment.py - Flask routes → Mock sentiment: uses on fallback
app.py - Flask routes → Scoring engine: normalizes and compares
app.py - Flask routes → Educational summary: requests explanation
app.py - Educational summary → Grok API: requests summary
data/ai_summary.py - Flask routes → Results view: renders results
app.py