# tegagabunia123/quantitative-finance-research architecture

> Architecture diagram of the GitHub repository tegagabunia123/quantitative-finance-research, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tegagabunia123/quantitative-finance-research
- Repository: https://github.com/tegagabunia123/quantitative-finance-research

## Overview

This is a Streamlit-hosted quantitative research archive, organized around portfolio/network analytics, macro-liquidity studies, and AI-stock valuation metrics. Users select a research domain and model in the dashboard; it executes the selected script and displays its Matplotlib figure. The scripts obtain market and economic data, calculate measures, and produce charts. The README also describes asset-allocation and backtesting capabilities. Evidence is uneven: the dashboard and selected analyses were excerpted, while many model scripts were not; links from those categories to particular data sources or calculations are therefore omitted.

Main entry points: [`dashboard.py`](https://github.com/tegagabunia123/quantitative-finance-research/blob/main/dashboard.py) (Model dashboard), [`qt-macro-liquidity`](https://github.com/tegagabunia123/quantitative-finance-research/tree/main/qt-macro-liquidity) (Macro studies), [`graph-theory-portfolios`](https://github.com/tegagabunia123/quantitative-finance-research/tree/main/graph-theory-portfolios) (Portfolio models), [`ai-bubble-speculation`](https://github.com/tegagabunia123/quantitative-finance-research/tree/main/ai-bubble-speculation) (Valuation studies)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Research interface"]
  node_dashboard["Model dashboard<br/>[dashboard.py]"]
  node_charts["Displayed charts<br/>[dashboard.py]"]
end

subgraph group_portfolio["Portfolio analytics"]
  node_portfolio_models["Portfolio models"]
end

subgraph group_macro["Macro liquidity"]
  node_macro_models["Macro studies"]
end

subgraph group_valuation["AI valuation"]
  node_valuation_models["Valuation studies"]
end

node_researcher(("Researcher"))
node_market_data["Yahoo Finance"]
node_fred_data["FRED"]

node_researcher -->|"selects model"| node_dashboard
node_dashboard -->|"routes selection"| node_portfolio_models
node_dashboard -->|"routes selection"| node_macro_models
node_dashboard -->|"routes selection"| node_valuation_models
node_dashboard -->|"displays figure"| node_charts
node_portfolio_models -->|"downloads prices"| node_market_data
node_macro_models -->|"downloads prices"| node_market_data
node_macro_models -->|"reads series"| node_fred_data
node_valuation_models -->|"fetches financials"| node_market_data

click node_dashboard "https://github.com/tegagabunia123/quantitative-finance-research/blob/main/dashboard.py"
click node_portfolio_models "https://github.com/tegagabunia123/quantitative-finance-research/tree/main/graph-theory-portfolios"
click node_macro_models "https://github.com/tegagabunia123/quantitative-finance-research/tree/main/qt-macro-liquidity"
click node_valuation_models "https://github.com/tegagabunia123/quantitative-finance-research/tree/main/ai-bubble-speculation"
click node_charts "https://github.com/tegagabunia123/quantitative-finance-research/blob/main/dashboard.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_charts toneBlue
class node_portfolio_models toneAmber
class node_macro_models toneMint
class node_valuation_models toneRose
class node_researcher,node_market_data,node_fred_data toneIndigo
```

## Components

### Research interface

- [Model dashboard](https://github.com/tegagabunia123/quantitative-finance-research/blob/main/dashboard.py): `dashboard.py`
- [Displayed charts](https://github.com/tegagabunia123/quantitative-finance-research/blob/main/dashboard.py): `dashboard.py`

### Portfolio analytics

- [Portfolio models](https://github.com/tegagabunia123/quantitative-finance-research/tree/main/graph-theory-portfolios): `graph-theory-portfolios`

### Macro liquidity

- [Macro studies](https://github.com/tegagabunia123/quantitative-finance-research/tree/main/qt-macro-liquidity): `qt-macro-liquidity`

### AI valuation

- [Valuation studies](https://github.com/tegagabunia123/quantitative-finance-research/tree/main/ai-bubble-speculation): `ai-bubble-speculation`

### Other components

- **Researcher**
- **Yahoo Finance**
- **FRED**

## Connections

- Researcher → Model dashboard: selects model (evidence: `dashboard.py`)
- Model dashboard → Portfolio models: routes selection (evidence: `dashboard.py`)
- Model dashboard → Macro studies: routes selection (evidence: `dashboard.py`)
- Model dashboard → Valuation studies: routes selection (evidence: `dashboard.py`)
- Model dashboard → Displayed charts: displays figure (evidence: `dashboard.py`)
- Portfolio models → Yahoo Finance: downloads prices (evidence: `graph-theory-portfolios/monthly_average_returns_graph.py`)
- Macro studies → Yahoo Finance: downloads prices (evidence: `qt-macro-liquidity/fed_balance_sheet_vs_sandp500_and_vix.py`)
- Macro studies → FRED: reads series (evidence: `qt-macro-liquidity/fed_balance_sheet_vs_sandp500_and_vix.py`)
- Valuation studies → Yahoo Finance: fetches financials (evidence: `ai-bubble-speculation/11_revenue_growth.py`)
