# pawandamo-cyber/ai-indian-stock-market-analyzer architecture

> Architecture diagram of the GitHub repository pawandamo-cyber/ai-indian-stock-market-analyzer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pawandamo-cyber/ai-indian-stock-market-analyzer
- Repository: https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer

## Overview

TradeIQ is a Streamlit stock-market intelligence platform. Users select a company or portfolio in the dashboard, then view market and company data, charts, technical and financial analysis, news, comparisons, AI summaries, or portfolio insights; financial reports can be exported. The graph groups the UI, market/company analysis, and portfolio/report capabilities. Links from app.py are supported by its indexed imports; some unsampled service behavior is represented only where the README documents it. External news-feed wiring is not verified in the excerpts.

Main entry points: [`app.py`](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/app.py) (Streamlit Dashboard), [`services/market_service.py`](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/market_service.py) (Market Overview), [`services/portfolio_service.py`](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/portfolio_service.py) (Portfolio Analysis), [`components/stock_search_widget.py`](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/components/stock_search_widget.py) (Company Search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard"]
  node_dashboard["Streamlit Dashboard<br/>[app.py]"]
  node_search_widget["Company Search"]
  node_news_view["News Display<br/>[news_component.py]"]
end

subgraph group_market["Market Analysis"]
  node_market_service["Market Overview<br/>[market_service.py]"]
  node_nifty_list["NIFTY 50 Symbols<br/>[nifty50.py]"]
  node_ticker["Market Ticker"]
  node_news_service["News Feeds<br/>[news_service.py]"]
end

subgraph group_insights["Company Insights"]
  node_search_service["Stock Search"]
  node_symbols[("NSE Symbol Master<br/>[nse_symbols.csv]")]
  node_stock_data["Stock Data<br/>[stock_service.py]"]
  node_charts["Interactive Charts<br/>[chart_service.py]"]
  node_technicals["Technical Indicators"]
  node_financials["Financial Analysis"]
  node_comparison["Stock Comparison<br/>[compare_service.py]"]
  node_ai["AI Analysis<br/>[ai_service.py]"]
end

subgraph group_portfolio["Portfolio and Reports"]
  node_portfolio_service["Portfolio Analysis"]
  node_portfolio_files[("Portfolio History CSVs<br/>[portfolio.csv]")]
  node_reports["Financial Exports<br/>[report_service.py]"]
end

node_investor(("Investor"))
node_gemini{{"Google Gemini"}}
node_yahoo{{"Yahoo Finance"}}

node_investor -->|"uses"| node_dashboard
node_dashboard -->|"renders"| node_search_widget
node_search_widget -->|"searches"| node_search_service
node_search_service -->|"reads"| node_symbols
node_dashboard -->|"requests data"| node_stock_data
node_dashboard -->|"requests charts"| node_charts
node_dashboard -->|"requests indicators"| node_technicals
node_dashboard -->|"requests statements"| node_financials
node_dashboard -->|"requests comparison"| node_comparison
node_dashboard -->|"requests analysis"| node_ai
node_ai -->|"generates summaries"| node_gemini
node_dashboard -->|"requests overview"| node_market_service
node_market_service -->|"uses symbols"| node_nifty_list
node_dashboard -->|"loads ticker"| node_ticker
node_dashboard -->|"requests news"| node_news_service
node_dashboard -->|"renders news"| node_news_view
node_dashboard -->|"requests portfolio"| node_portfolio_service
node_portfolio_service -->|"reads and writes"| node_portfolio_files
node_dashboard -->|"exports reports"| node_reports
node_stock_data -->|"fetches prices"| node_yahoo
node_charts -->|"fetches history"| node_yahoo
node_technicals -->|"fetches history"| node_yahoo
node_financials -->|"fetches statements"| node_yahoo
node_market_service -->|"fetches indices"| node_yahoo
node_portfolio_service -->|"refreshes prices"| node_yahoo
node_news_service -.->|"publishes live news"| node_investor

click node_dashboard "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/app.py"
click node_search_widget "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/components/stock_search_widget.py"
click node_search_service "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/stock_search_service.py"
click node_symbols "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/Data/nse_symbols.csv"
click node_stock_data "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/stock_service.py"
click node_charts "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/chart_service.py"
click node_technicals "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/technical_service.py"
click node_financials "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/financial_service.py"
click node_comparison "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/compare_service.py"
click node_ai "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/ai_service.py"
click node_market_service "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/market_service.py"
click node_nifty_list "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/Data/nifty50.py"
click node_ticker "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/market_ticker_service.py"
click node_news_service "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/news_service.py"
click node_news_view "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/components/news_component.py"
click node_portfolio_service "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/portfolio_service.py"
click node_portfolio_files "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/portfolio.csv"
click node_reports "https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/report_service.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_search_widget,node_news_view toneBlue
class node_market_service,node_nifty_list,node_ticker,node_news_service toneAmber
class node_search_service,node_symbols,node_stock_data,node_charts,node_technicals,node_financials,node_comparison,node_ai toneMint
class node_portfolio_service,node_portfolio_files,node_reports toneRose
class node_investor,node_gemini,node_yahoo toneIndigo
```

## Components

### Dashboard

- [Streamlit Dashboard](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/app.py): `app.py`
- [Company Search](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/components/stock_search_widget.py): `components/stock_search_widget.py`
- [News Display](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/components/news_component.py): `components/news_component.py`

### Market Analysis

- [Market Overview](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/market_service.py): `services/market_service.py`
- [NIFTY 50 Symbols](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/Data/nifty50.py): `Data/nifty50.py`
- [Market Ticker](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/market_ticker_service.py): `services/market_ticker_service.py`
- [News Feeds](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/news_service.py): `services/news_service.py`

### Company Insights

- [Stock Search](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/stock_search_service.py): `services/stock_search_service.py`
- [NSE Symbol Master](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/Data/nse_symbols.csv): `Data/nse_symbols.csv`
- [Stock Data](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/stock_service.py): `services/stock_service.py`
- [Interactive Charts](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/chart_service.py): `services/chart_service.py`
- [Technical Indicators](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/technical_service.py): `services/technical_service.py`
- [Financial Analysis](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/financial_service.py): `services/financial_service.py`
- [Stock Comparison](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/compare_service.py): `services/compare_service.py`
- [AI Analysis](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/ai_service.py): `services/ai_service.py`

### Portfolio and Reports

- [Portfolio Analysis](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/portfolio_service.py): `services/portfolio_service.py`
- [Portfolio History CSVs](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/portfolio.csv): `portfolio.csv`
- [Financial Exports](https://github.com/pawandamo-cyber/ai-indian-stock-market-analyzer/blob/main/services/report_service.py): `services/report_service.py`

### Other components

- **Investor**
- **Google Gemini**
- **Yahoo Finance**

## Connections

- Investor → Streamlit Dashboard: uses (evidence: `README.md`)
- Streamlit Dashboard → Company Search: renders (evidence: `app.py`)
- Company Search → Stock Search: searches (evidence: `components/stock_search_widget.py`)
- Stock Search → NSE Symbol Master: reads (evidence: `services/stock_search_service.py`)
- Streamlit Dashboard → Stock Data: requests data (evidence: `app.py`)
- Streamlit Dashboard → Interactive Charts: requests charts (evidence: `app.py`)
- Streamlit Dashboard → Technical Indicators: requests indicators (evidence: `app.py`)
- Streamlit Dashboard → Financial Analysis: requests statements (evidence: `app.py`)
- Streamlit Dashboard → Stock Comparison: requests comparison (evidence: `app.py`)
- Streamlit Dashboard → AI Analysis: requests analysis (evidence: `app.py`)
- AI Analysis → Google Gemini: generates summaries (evidence: `services/ai_service.py`)
- Streamlit Dashboard → Market Overview: requests overview (evidence: `app.py`)
- Market Overview → NIFTY 50 Symbols: uses symbols (evidence: `services/market_service.py`)
- Streamlit Dashboard → Market Ticker: loads ticker (evidence: `app.py`)
- Streamlit Dashboard → News Feeds: requests news (evidence: `app.py`)
- Streamlit Dashboard → News Display: renders news (evidence: `app.py`)
- Streamlit Dashboard → Portfolio Analysis: requests portfolio (evidence: `app.py`)
- Portfolio Analysis → Portfolio History CSVs: reads and writes (evidence: `services/portfolio_service.py`)
- Streamlit Dashboard → Financial Exports: exports reports (evidence: `app.py`)
- Stock Data → Yahoo Finance: fetches prices (evidence: `services/stock_service.py`)
- Interactive Charts → Yahoo Finance: fetches history (evidence: `services/chart_service.py`)
- Technical Indicators → Yahoo Finance: fetches history (evidence: `services/technical_service.py`)
- Financial Analysis → Yahoo Finance: fetches statements (evidence: `services/financial_service.py`)
- Market Overview → Yahoo Finance: fetches indices (evidence: `services/market_service.py`)
- Portfolio Analysis → Yahoo Finance: refreshes prices (evidence: `services/portfolio_service.py`)
- News Feeds → Investor: publishes live news
