How username67-afk/ai-investment-terminal works
This is a terminal-based Indian-stock research tool. Users search mapped companies, then the CLI gathers market data and presents technical returns, risk metrics, fundamentals, and headline sentiment; separate menu flows compare stocks and manage a portfolio and watchlist. The graph preserves those documented capabilities, including signals and ASCII charts. The source excerpts show the main CLI calls and data-service relationships; signals and charts are documented as not yet integrated into the main analysis flow.
Main entry points: app.py CLI menus · market_data.py Market data · storage.py Cache and user storage · settings.py Application settings
Components 18
Terminal workflows
- CLI menus
app.py
Research analysis
- Technical indicators
analysis/technical.py - Risk metrics
analysis/risk.py - News sentiment
models/sentiment_model.py - Signal engine
analysis/signals.py - Portfolio analysis
analysis/portfolio.py - ASCII charts
ui/terminal_charts.py
Data services
- Company search
services/company_search.py - Company mapping
data/company_mapping.csv - Market data
services/market_data.py - News retrieval
services/news_data.py - Application settings
config/settings.py
Local persistence
- Cache and user storage
utils/storage.py - Response cache
data/cache - Portfolio and watchlist
data/user_data.json
Other components
- Researcher
- Yahoo Finance
- Google News RSS
Connections 22
- Researcher → CLI menus: selects workflow
README.md - CLI menus → Company search: searches companies
app.py - Company search → Company mapping: reads mapping
services/company_search.py - CLI menus → Market data: requests market data
app.py - Market data → Yahoo Finance: fetches prices
services/market_data.py - CLI menus → Technical indicators: computes indicators
app.py - CLI menus → Risk metrics: computes risk
app.py - CLI menus → News retrieval: requests headlines
app.py - News retrieval → Google News RSS: queries RSS
services/news_data.py - CLI menus → News sentiment: scores headlines
app.py - CLI menus → Portfolio analysis: summarizes holdings
app.py - Portfolio analysis → Market data: gets quotes and history
analysis/portfolio.py - CLI menus → Cache and user storage: reads and updates lists
app.py - Cache and user storage → Portfolio and watchlist: reads and writes
utils/storage.py - Market data → Cache and user storage: uses cache
services/market_data.py - Cache and user storage → Response cache: reads and writes
utils/storage.py - Company search → Application settings: gets mapping path
services/company_search.py - Market data → Application settings: gets defaults
services/market_data.py - News retrieval → Application settings: gets feed settings
services/news_data.py - Risk metrics → Application settings: gets risk-free rate
analysis/risk.py - CLI menus → Signal engine: planned integration
README.md - CLI menus → ASCII charts: planned integration
README.md