StockMonitor AI — Stock Intelligence, Critical Minerals & Energy Geo-Dependencies

⛓️

Geo-Dependency Engine

Maps every stock to its critical-mineral and key-energy inputs, then resolves the producer & processor countries that dominate them — and the maritime chokepoints its supply must transit. Country concentration is derived from a curated mine, refinery, and chokepoint dataset, not guesswork.

📊

Stock Global Intelligence

AI-powered analysis that synthesizes global data sources — now enriched with mineral, energy, and chokepoint supply-chain risks — to provide stock-specific geopolitical and macro insights in real-time.

🌐

Global Situation Monitor

Strategic risk overview dashboard tracking global events, intelligence alerts, and market implications across 30+ data sources.

📈

Stock Monitor

A persistent portfolio with real-time quotes, returns, and concentration risk. Add, edit, or remove holdings, upload a CSV, and tune alert & risk thresholds — everything is saved locally and rides settings export/sync.

🤖

Browser-Based LLM

ONNX-powered text analysis runs locally in your browser using Transformers.js. No data leaves your machine.

⚡

Real-Time Updates

Live news feeds, intelligence events, market data, and satellite imagery update continuously with event-driven architecture.

🔒

Privacy First

No subscription required. All features available to all users. Open-source. Full control over your data.

⛓️ Geo-Dependency Engine

The wiring behind every stock

Most tools stop at "where is this company headquartered?" StockMonitor goes deeper: it models the critical minerals and key energy a business actually depends on, traces those inputs to the countries that mine and refine them, and flags the maritime chokepoints the supply must pass through. The result is a single dependency score that reflects real geopolitical exposure — not just the flag on the logo.

What it surfaces per stock

🪨 Critical Minerals

Rare earths, lithium, cobalt, nickel, copper, tin, aluminum and more — with the reason each one matters to the business

🌍 Producer & Processor Concentration

Top mining and refining countries per mineral, with a concentration score derived from a curated mine & plant dataset

⚡ Key Energy Inputs

Crude oil, natural gas / LNG, refined fuels, grid electricity, nuclear fuel and coal — mapped to their source regions

🚢 Maritime Chokepoints

Hormuz, Malacca, Taiwan Strait, Bab-el-Mandeb, Suez, Panama and more — the routes a stock's supply transits

📊 Dependency Score

A 0–100 composite of mineral concentration, energy intensity, and chokepoint load with a low / medium / high band

🗺️ On the Map

Producer countries and at-risk chokepoints light up on the globe when you select a stock

How a dependency is resolved

Each stock is mapped to its critical-mineral and key-energy inputs (per-company profiles with sector-template fallbacks)

Producer & processor country concentration is computed from the app's curated mine and refinery dataset

Minerals and energy are linked to the maritime chokepoints their supply must transit, each risk-coded

A composite geo-dependency score is produced and surfaced in the panel, the AI intelligence feed, and the map

Example wirings

NVDA → Rare Earths · Taiwan Strait TSLA → Lithium / Cobalt / Nickel ASML → Tin (EUV) · Rare Earths XOM / ENB → Crude · LNG · Hormuz BA → Aluminum · Nickel superalloys DSX → Bunker fuel · Iron ore freight

Stock Global Intelligence

How It Works

Select any stock in the Stock Monitor panel and the AI instantly analyzes how global events affect it. The system aggregates live news, geopolitical intelligence, market signals, supply chain risks, macro indicators—then uses browser-based LLM to generate actionable insights specific to that stock and sector.

Data Sources Analyzed

📰 Live News Headlines

Sector-relevant news filtered from 30+ global sources

🔍 Intelligence Events

Geopolitical, conflict, and threat alerts from GDELT

📈 Market Signals

Volatility spikes, sector rotations, unusual volume

🔗 Supply Chain Risks

Country exposure plus modeled critical-mineral, energy, and chokepoint dependencies

⚠️ Geopolitical Threats

Sanctions, conflicts, policy changes affecting sectors

💹 Macro Indicators

VIX, Gold, DXY, Yield Curve, commodity prices

Analysis Workflow

User selects a stock from the Stock Monitor portfolio

System aggregates all relevant global data for that stock's sector and geographic exposure

Browser-based LLM (ONNX Transformers.js) analyzes context and generates insights

Results display with confidence score and supporting data points

Results are cached to prevent re-analysis on re-selection

Technology Stack

TypeScript Vite Preact ONNX Transformers.js Web Workers IndexedDB Custom Events Edge Functions Redis (Upstash)

Features

Core Capabilities

✅ Geo-Dependency Engine - Critical-mineral, key-energy, and maritime-chokepoint wiring per stock with a 0–100 dependency score
✅ Persistent Portfolio - Add, edit, or remove holdings, upload CSV; shares, cost basis, and buy dates are saved locally
✅ Configurable Settings - Tune alert impact threshold, concentration risk bands, default shares, and base currency — included in settings export/sync
✅ Producer/Processor Concentration - Country dominance per mineral derived from a curated mine & refinery dataset
✅ Real-Time Map - Producer countries and at-risk chokepoints light up on the interactive globe
✅ Stock Global Intelligence - AI synthesis enriched with the modeled supply-chain risks
✅ Local LLM Models - Ollama and LM Studio integration for continued analysis
✅ Custom Monitors - Alert on specific tickers, countries, or events
✅ Dark Mode - Easy on the eyes for extended use
✅ 100% Open Source - Self-hostable

Getting Started

Live Demo

Visit the live application at sinhaankur.github.io/Stockmonitor

Self-Host

Clone the repository and run locally:

          git clone https://github.com/sinhaankur/Stockmonitor

cd Stockmonitor

npm install

npm run dev

Usage

Click on Stock Monitor panel or search for a ticker (your portfolio persists across reloads)
Select any stock to open its detail view, then jump to Geo-wiring to see its mineral, energy, and chokepoint dependencies
The Stock Global Intelligence panel generates insights enriched with those supply-chain risks
Open the panel ⚙ Settings to tune alert and concentration-risk thresholds
Optional: Connect local LLM via Settings ⚡ Connect AI button

📈 StockMonitor AI

Geo-Dependency Engine

Stock Global Intelligence

Global Situation Monitor

Stock Monitor

Browser-Based LLM

Real-Time Updates

Privacy First

⛓️ Geo-Dependency Engine

The wiring behind every stock

What it surfaces per stock

🪨 Critical Minerals

🌍 Producer & Processor Concentration

⚡ Key Energy Inputs

🚢 Maritime Chokepoints

📊 Dependency Score

🗺️ On the Map

How a dependency is resolved

Example wirings

Stock Global Intelligence

How It Works

Data Sources Analyzed

📰 Live News Headlines

🔍 Intelligence Events

📈 Market Signals

🔗 Supply Chain Risks

⚠️ Geopolitical Threats

💹 Macro Indicators

Analysis Workflow

Technology Stack

Features

Core Capabilities

Getting Started

Live Demo

Self-Host

Usage

Documentation