stockmonitor / README.md
sinhaankur's picture
Upload README.md with huggingface_hub
99a1264 verified
|
Raw
History Blame Contribute Delete
2.44 kB
metadata
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 — 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 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

License

AGPL-3.0, inherited from World Monitor, the upstream project this builds on.