| --- |
| license: agpl-3.0 |
| language: |
| - en |
| tags: |
| - finance |
| - stocks |
| - portfolio |
| - geopolitics |
| - critical-minerals |
| - energy-security |
| - supply-chain |
| - local-llm |
| - privacy |
| - dashboard |
| pretty_name: StockMonitor — stocks wired to critical minerals, energy & chokepoints |
| --- |
| |
| # StockMonitor |
|
|
| > *This repository is **not** a model.* It is the **project home / card** for |
| > [StockMonitor](https://github.com/sinhaankur/Stockmonitor) — a stock-monitoring |
| > dashboard that maps the real geopolitical supply-chain wiring behind every stock |
| > you hold. The runnable code lives on GitHub; nothing here downloads weights. |
|
|
| A stock-focused layer on top of the [World Monitor](https://worldmonitor.app) |
| global-intelligence dashboard. Beyond "where is this company headquartered?", |
| StockMonitor models the **critical minerals** and **key energy** a business depends |
| on, traces them to the countries that mine and refine them, and flags the **maritime |
| chokepoints** the supply must transit. |
|
|
| ## What it does |
|
|
| - **Geo-Dependency Engine** — maps every stock to its critical-mineral and |
| key-energy inputs, the producer/processor countries that dominate them, and the |
| maritime chokepoints its supply transits, with a 0–100 dependency score. Country |
| concentration is derived from a curated mine, refinery, and chokepoint dataset — |
| not guesswork. |
| - **Persistent portfolio** — add/edit/remove holdings or upload CSV; shares, cost |
| basis, buy dates, and tunable alert/risk thresholds are saved locally and ride |
| settings export/sync. |
| - **Stock Global Intelligence** — AI synthesis enriched with the modeled mineral, |
| energy, and chokepoint supply-chain risks. |
| - **Live map** — producer countries and at-risk chokepoints light up on the globe |
| when you select a stock. |
|
|
| ## Example wirings |
|
|
| | Stock | Critical inputs | Chokepoint | |
| | --- | --- | --- | |
| | NVDA | Rare earths · copper | Taiwan Strait | |
| | TSLA | Lithium · cobalt · nickel | — | |
| | ASML | Tin (EUV) · rare earths | — | |
| | XOM / ENB | Crude · LNG | Strait of Hormuz | |
| | BA | Aluminum · nickel superalloys | — | |
|
|
| ## Links |
|
|
| - **Live app:** <https://sinhaankur.github.io/Stockmonitor/> |
| - **Overview page:** <https://sinhaankur.github.io/Stockmonitor/marketing/> |
| - **Source:** <https://github.com/sinhaankur/Stockmonitor> |
|
|
| ## License |
|
|
| AGPL-3.0, inherited from [World Monitor](https://github.com/koala73/worldmonitor), |
| the upstream project this builds on. |
|
|
