# julestristan/himid architecture

> Architecture diagram of the GitHub repository julestristan/himid, 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/julestristan/himid
- Repository: https://github.com/julestristan/himid

## Overview

Himid is a portfolio-monitoring app that fetches market data, calculates investment performance and correlations, and presents analysis through a Streamlit dashboard and emailed report. The main report workflow is implemented in `src/main.py`; the dashboard calls correlation analysis directly. Rust supplies the performance calculation. Source excerpts show these connections, but do not establish any scheduler or persistent storage.

Main entry points: [`src/main.py`](https://github.com/julestristan/himid/blob/main/src/main.py) (Report generation), [`src/app.py`](https://github.com/julestristan/himid/blob/main/src/app.py) (Streamlit dashboard), [`src/cor_matrix.py`](https://github.com/julestristan/himid/blob/main/src/cor_matrix.py) (Correlation heatmap), [`himid-core/src/lib.rs`](https://github.com/julestristan/himid/blob/main/himid-core/src/lib.rs) (Performance calculation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interfaces"]
  node_dashboard["Streamlit dashboard<br/>[app.py]"]
end

subgraph group_analytics["Portfolio analytics"]
  node_portfolio["Portfolio holdings<br/>[main.py]"]
  node_correlation["Correlation heatmap<br/>[cor_matrix.py]"]
  node_performance["Performance calculation<br/>[lib.rs]"]
  node_news_analysis["Daily-move analysis<br/>[main.py]"]
end

subgraph group_delivery["Report and integrations"]
  node_report["Report generation<br/>[main.py]"]
  node_email_sender["Email delivery<br/>[main.py]"]
  node_market_data["Yahoo Finance"]
  node_llm["OpenAI API"]
  node_smtp["Gmail SMTP"]
end

node_investor(("Investor"))
node_recipient(("Email recipient"))

node_investor -->|"opens"| node_dashboard
node_investor -->|"runs"| node_report
node_dashboard -->|"loads holdings"| node_portfolio
node_dashboard -->|"requests heatmap"| node_correlation
node_correlation -->|"downloads prices"| node_market_data
node_report -->|"reads holdings"| node_portfolio
node_report -->|"fetches quotes"| node_market_data
node_report -->|"calculates returns"| node_performance
node_report -->|"requests analysis"| node_news_analysis
node_news_analysis -->|"fetches news"| node_market_data
node_news_analysis -->|"requests explanation"| node_llm
node_dashboard -->|"requests diversification"| node_llm
node_report -->|"builds heatmaps"| node_correlation
node_report -->|"sends report"| node_email_sender
node_email_sender -->|"sends message"| node_smtp
node_smtp -.->|"delivers email"| node_recipient

click node_dashboard "https://github.com/julestristan/himid/blob/main/src/app.py"
click node_report "https://github.com/julestristan/himid/blob/main/src/main.py"
click node_portfolio "https://github.com/julestristan/himid/blob/main/src/main.py"
click node_correlation "https://github.com/julestristan/himid/blob/main/src/cor_matrix.py"
click node_performance "https://github.com/julestristan/himid/blob/main/himid-core/src/lib.rs"
click node_news_analysis "https://github.com/julestristan/himid/blob/main/src/main.py"
click node_email_sender "https://github.com/julestristan/himid/blob/main/src/main.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 toneBlue
class node_portfolio,node_correlation,node_performance,node_news_analysis toneAmber
class node_report,node_email_sender,node_market_data,node_llm,node_smtp toneMint
class node_investor,node_recipient toneIndigo
```

## Components

### User interfaces

- [Streamlit dashboard](https://github.com/julestristan/himid/blob/main/src/app.py): `src/app.py`

### Portfolio analytics

- [Portfolio holdings](https://github.com/julestristan/himid/blob/main/src/main.py): `src/main.py`
- [Correlation heatmap](https://github.com/julestristan/himid/blob/main/src/cor_matrix.py): `src/cor_matrix.py`
- [Performance calculation](https://github.com/julestristan/himid/blob/main/himid-core/src/lib.rs): `himid-core/src/lib.rs`
- [Daily-move analysis](https://github.com/julestristan/himid/blob/main/src/main.py): `src/main.py`

### Report and integrations

- [Report generation](https://github.com/julestristan/himid/blob/main/src/main.py): `src/main.py`
- [Email delivery](https://github.com/julestristan/himid/blob/main/src/main.py): `src/main.py`
- **Yahoo Finance**
- **OpenAI API**
- **Gmail SMTP**

### Other components

- **Investor**
- **Email recipient**

## Connections

- Investor → Streamlit dashboard: opens (evidence: `src/app.py`)
- Investor → Report generation: runs (evidence: `src/main.py`)
- Streamlit dashboard → Portfolio holdings: loads holdings (evidence: `src/app.py`)
- Streamlit dashboard → Correlation heatmap: requests heatmap (evidence: `src/app.py`)
- Correlation heatmap → Yahoo Finance: downloads prices (evidence: `src/cor_matrix.py`)
- Report generation → Portfolio holdings: reads holdings (evidence: `src/main.py`)
- Report generation → Yahoo Finance: fetches quotes (evidence: `src/main.py`)
- Report generation → Performance calculation: calculates returns (evidence: `src/main.py`)
- Report generation → Daily-move analysis: requests analysis (evidence: `src/main.py`)
- Daily-move analysis → Yahoo Finance: fetches news (evidence: `src/main.py`)
- Daily-move analysis → OpenAI API: requests explanation (evidence: `src/main.py`)
- Streamlit dashboard → OpenAI API: requests diversification (evidence: `src/app.py`)
- Report generation → Correlation heatmap: builds heatmaps (evidence: `src/main.py`)
- Report generation → Email delivery: sends report (evidence: `src/main.py`)
- Email delivery → Gmail SMTP: sends message (evidence: `src/main.py`)
- Gmail SMTP → Email recipient: delivers email
