How sahniaditya007/stock-sense works
This is a stock-question answering demo: a user submits a natural-language or structured query, the Flask interface passes it to the orchestrator, and the orchestrator identifies a ticker, gathers price-change and news data, and produces a summary. The repository also has a current-price agent, but the sampled orchestrator imports it without invoking it. API wiring is based on sampled source; the README documents the intended capabilities and integrations.
Main entry points: orchestrator.py Query orchestrator · utils.py API configuration · web_demo.py Flask demo · ticker_price_change.py Price change
Components 11
Web interface
- Flask demo
web_demo.py
Query coordination
- Query orchestrator
orchestrator.py
Stock agents
- Ticker identification
agents/identify_ticker.py - Price change
agents/ticker_price_change.py - Recent news
agents/ticker_news.py - Movement analysis
agents/ticker_analysis.py - Current price
agents/ticker_price.py
Shared configuration
- API configuration
utils.py
Other components
- User
- Alpha Vantage
- News API
Connections 19
- User → Flask demo: submits query
- Flask demo → Query orchestrator: calls query handler
- Query orchestrator → Ticker identification: identifies ticker
- Ticker identification → Alpha Vantage: searches symbols
- Query orchestrator → Price change: gets price change
- Price change → Alpha Vantage: requests daily series
- Query orchestrator → Recent news: gets recent news
- Recent news → News API: searches articles
- Query orchestrator → Movement analysis: analyzes inputs
- Recent news → Movement analysis: provides headlines
- Price change → Movement analysis: provides change
- Movement analysis → Query orchestrator: returns summary
- Query orchestrator → Flask demo: returns result
- Flask demo → User: displays result
- Current price → Alpha Vantage: requests quote
- API configuration → Ticker identification: provides API settings
- API configuration → Price change: provides API settings
- API configuration → Recent news: provides API settings
- API configuration → Current price: provides API settings