Skip to content

Repository files navigation


██████╗ ██████╗ ███████╗██╗ ██╗██╗ ██╗███████╗
██╔══██╗██╔══██╗██╔════╝╚██╗██╔╝██║ ██║██╔════╝
██████╔╝██████╔╝█████╗ ╚███╔╝ ██║ ██║███████╗
██╔═══╝ ██╔══██╗██╔══╝ ██╔██╗ ██║ ██║╚════██║
██║ ██║ ██║███████╗██╔╝ ██╗╚██████╔╝███████║
╚═╝ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚══════╝

Sovereign AI Intelligence System

Anticipating systemic risk before it materialises


StatusEngineClearanceLicense UILicense Core


For governments, financial institutions, and enterprise operators


Platform Overview · Architecture · Intelligence Modules · API Reference · Licensing



Prexus — Sovereign AI Intelligence System

What is Prexus?

Prexus is an AI-driven system designed to predict large-scale risks and outcomes across complex systems such as infrastructure, geopolitics, and institutional decision-making.

Instead of reacting to events, Prexus focuses on anticipating them.



Why this matters

Modern systems are becoming:

  • Highly interconnected
  • Increasingly unpredictable
  • Difficult to manage using traditional models

Governments and institutions today rely on reactive strategies.

Prexus aims to shift this from reaction → prediction.



What we've built

  • Early-stage prototype
  • Monte Carlo simulation engine (Python + Rust)
  • Scenario-based risk modeling
  • Probabilistic outcome forecasting


Example Output

Input:

  • System variables (economic, infrastructure, external risks)

Output:

  • Probability of specific events
  • Simulation paths across multiple scenarios
  • Risk distribution over time


How it works (simplified)

1. Define system variables
2. Run thousands of simulations
3. Analyze probability distributions
4. Generate predictive insights


Current Status

ComponentStatus
Core simulation engine✅ Functional
Prototype✅ Completed
Meteorium (Climate Risk)✅ Live
Real-world dataset integration🔄 Expanding
Healtho (Health Intelligence)🔨 In Build
Raksha (Threat Intelligence)🔨 In Build


Vision

To build a sovereign intelligence layer that enables:

  • Governments to predict risks before they occur
  • Institutions to make high-stakes decisions with data-backed foresight
  • Systems to evolve from reactive → predictive


Tech Stack

  • Python + FastAPI
  • Rust (Monte Carlo simulation core)
  • Go (API Gateway)
  • Simulation modeling
  • Probabilistic analysis


Next Steps

  • Improve model accuracy
  • Integrate real-world datasets
  • Build scalable architecture


Platform Architecture

Prexus is built as a distributed, polyglot system — each layer uses the best-fit language for its role.

┌─────────────────────────────────────────────────────────────┐
│ CLIENT LAYER │
│ Gov Dashboards · Financial Terminals · Enterprise │
└──────────────────────────┬──────────────────────────────────┘
│ HTTPS / TLS 1.3
┌──────────────────────────▼──────────────────────────────────┐
│ API GATEWAY (Go) │
│ JWT Auth · ABAC · Rate Limiting · CORS · Audit Log │
└───────────────┬─────────────────────────┬───────────────────┘
│ │
┌───────────────▼──────────┐ ┌───────────▼───────────────────┐
│ INTELLIGENCE LAYER │ │ COMPUTE LAYER │
│ (Python) │ │ (Rust) │
│ · Risk Analytics │◄─► · Monte Carlo Engine │
│ · Scenario Models │ │ · VaR / CVaR │
│ · IPCC Pathways │ │ · Numerical Analysis │
└───────────────┬──────────┘ └───────────────────────────────┘
│
┌───────────────▼──────────────────────────────────────────────┐
│ DATA ADAPTER LAYER │
│ Sentinel-1 SAR · ECMWF · Bloomberg · IPCC AR6 │
└───────────────────────────────────────────────────────────────┘

Layer Breakdown

LayerLanguageRoleKey Capability
API GatewayGoRequest routing, auth, auditZero-trust ABAC, JWT, rate limiting, SHA-256 hash chain
Intelligence EnginePython / FastAPIAnalytics orchestrationRisk scoring, scenario modelling, IPCC pathway integration
Compute AccelerationRustHigh-performance numericsMonte Carlo simulation, VaR/CVaR, loss distribution
Data AdaptersPythonExternal data ingestionClimate, environmental, financial signal normalisation
Audit LedgerGoImmutable event logSHA-256 hash-chained tamper-evident records


Intelligence Modules

Prexus is a multi-module intelligence platform. Each module addresses a distinct institutional risk domain. They share a common compute layer, auth infrastructure, and audit ledger.


◆ Meteorium — Climate Risk Intelligence

Status: Live

Meteorium is the environmental intelligence core of Prexus — a dedicated risk computation engine for physical climate exposure analysis. It is the first module in production.

┌─────────────────────────────────────────────────────┐
│ METEORIUM ENGINE │
├──────────────────────────┬──────────────────────────┤
│ Input Parameters │ Intelligence Output │
├──────────────────────────┼──────────────────────────┤
│ · Asset coordinates │ · Composite Risk Score │
│ · Asset valuation │ · VaR 95% │
│ · Prediction horizon │ · CVaR 95% │
│ (180d / 1y / 3y) │ · Expected Loss │
│ · Urban density factor │ · Risk Band │
│ · Climate scenario │ · Audit Receipt │
│ · Insurance coverage │ │
│ · Liquidity shock factor │ │
└──────────────────────────┴──────────────────────────┘
STOCHASTIC SIMULATION CORE
┌───────────────────────────────────────────┐
│ 10,000 Monte Carlo iterations │
│ IPCC AR6 scenario integration │
│ Urban density amplification (λ) │
│ Insurance drag factor (δ) │
│ Liquidity shock multiplier (κ) │
└───────────────────────────────────────────┘

Supported Climate Scenarios

ScenarioIDDescriptionRisk Premium
🟢 BaselinebaselineOrderly, Paris-aligned policy+0%
🟡 Disorderly TransitiondisorderlyDelayed policy action, repricing shock+9%
🔴 Failed TransitionfailedNo policy correction, full physical exposure+16%

Prediction Horizons

TacticalStrategicStructural
180 Days1 Year3 Years
Near-term positioningCapital planningLong-run mispricing

Risk Band Classification

ScoreBandIndicator
≥ 0.85CRITICALImmediate exposure — intervention required
≥ 0.75HIGHElevated repricing risk — review urgently
≥ 0.60ELEVATEDMaterial risk — monitor closely
≥ 0.50MODERATEAcceptable range — standard monitoring


◆ Meteorium UI — 3D Climate Globe

Platform intelligence view. Add asset to see risk visualisation.

Screenshot / demo recording coming soon. The globe renders live climate risk heatmaps, asset pins with severity-graded warning tabs, RCP 8.5 scenario projection (2023–2050), and Meto AI — a 3-model intelligence assistant (Claude / GPT-4o / Gemini) with full portfolio context.



◆ Healtho — Health Intelligence Module

Status: In Build

Healtho applies the Prexus simulation core to population health and bio-systemic risk domains. Designed for national health authorities, pandemic preparedness agencies, and insurance actuaries.

Planned capabilities:

  • Epidemic spread modelling across urban networks
  • Healthcare system load forecasting under stress scenarios
  • Mortality and morbidity risk curves (Monte Carlo)
  • Bio-systemic shock propagation across economic sectors
  • Integration with WHO datasets and national health registries

Target clearance: Level 3 · Target deployment: National governments, Central health authorities



◆ Raksha — Threat Intelligence Module

Status: In Build

Raksha is the geopolitical and institutional threat layer of Prexus. Named for protection, it is designed to give sovereign operators 360-degree situational awareness across physical, cyber, and systemic threat vectors.

Planned capabilities:

  • Geopolitical risk scoring with probabilistic conflict modelling
  • Critical infrastructure threat surface analysis
  • Supply chain disruption forecasting
  • Cyber-physical threat correlation engine
  • Macro-economic instability early-warning system

Target clearance: Level 5 · Target deployment: National governments, Sovereign wealth funds, Defence ministries



API Reference

Base URL:https://prexus-intelligence.onrender.com

All protected endpoints require a Bearer JWT issued at registration.

Authentication Flow

Client Prexus API
│ │
├── POST /api/v1/auth/register ────────────►│
│ { orgName, email, password } │
│◄──────────────── 200 { token, org_id } ───┤ JWT · 15 min · Authorization
│ │ ABAC Clearance assigned
│ │
├── POST /api/v1/meteorium/run ────────────►│
│◄──────────── 200 { risk_score, VaR, ... } ┤ Level 2 clearance required
│ │

Endpoint Reference

GET /health — Liveness probe
// Response 200
{
"status": "operational",
"version": "2.0.0-prx",
"ts": "2025-01-01T00:00:00Z"
}
POST /api/v1/auth/register — Provision organisation
// Request body
{
"org_name": "Apex Capital Management",
"email": "operator@apex.com",
"password": "***************",
"org_type": "FINANCIAL",
"tier": "ENTERPRISE"
}
// Response 201
{
"ok": true,
"token": "eyJhR...",
"org_id": "ORG-7f3a9c2d",
"user_id": "USR-1a2b3c4d",
"role": "ORG_ADMIN",
"clearance": 2
}
POST /api/v1/meteorium/run — Full Monte Carlo climate risk simulation

Required headers:Authorization: Bearer <token> · Required clearance: Level 2 · Role: ORG_ADMIN

// Request body
{
"horizonDays": 365,
"scenario": "disorderly",
"UrbanDensity": 0.65,
"InsuranceDrag": 0.40,
"LiquidityShock": 0.30,
"AssetValue": 125000000
}
// Response 200
{
"ok": true,
"mission_id": "MIS-8f2a5b9c",
"intelligence_outputs": {
"risk_score": 0.78,
"var_95": 14.2,
"cvar_95": 21.1,
"expected_loss": 24879000,
"risk_band": "HIGH"
},
"simulation_params": {
"iterations": 10000,
"horizon_days": 3600,
"scenario": "disorderly"
}
}
POST /risk/asset — Single asset environmental risk (Python intelligence layer)
ParameterTypeDescription
asset_idstringUnique asset identifier
latfloatLatitude
lonfloatLongitude
country_codestringISO 3166-1 alpha-2
valuationfloatAsset value in USD
scenariostringbaseline | disorderly | failed
horizon_daysint180 | 365 | 1095
POST /risk/portfolio — Portfolio-level aggregated risk

Aggregate risk exposure across multiple assets.

Returns: composite risk score, expected portfolio loss, per-asset breakdown, scenario stress estimates, VaR/CVaR at portfolio level.

HTTP Status Codes

CodeMeaning
200Success
201Resource created (register)
400Malformed request body
401Missing or expired JWT
403Insufficient clearance / CORS origin blocked
429Rate limit exceeded (20 req / 10 s per IP)
500Internal server error


Security Model

Layer 1 — TLS 1.3 Edge encryption (client layer)
Layer 2 — JWT + ABAC Role-based access, 15 min TTL
Layer 3 — Rate Limiting 50 req/s max, 15 sec TLS autosave
Layer 4 — CORS Policy Origin allowlist per environment
Layer 5 — Audit Ledger All actions logged to tamper-evident chain
Layer 6 — Password Hashing SHA-256 + 100k iterations

ABAC Role Matrix

RoleClearanceAccessible Endpoints
PUBLIC0/health
ORG_VIEWER1/health, /auth/*
ORG_ADMIN2All above + /meteorium/run
SYS_OPERATOR3All above + admin routes
SOVEREIGN5All routes including /raksha/*

Audit Ledger

Every authenticated action is recorded in a tamper-evident hash-chained log:

{ action_org, ... } ──► hash: SHA-256 ──► prev_hash
│
Tamper entry 0 ──► all subsequent headers invalidated


Deployment

Cloud Stack

ServicePlatformRole
Go API GatewayRender Web ServiceAuth, routing, audit, rate limiting
Python IntelligenceRender Web ServiceAnalytics, risk modelling
FrontendNetlify CDNStatic web delivery
SecretsSentry CDN / Render Env VarsAPI keys, JWT secret (auto-generated)

Quick Deploy (15 min)

# Backend — Render# Push prexus-kernel to private GitHub repo → connect to Render# Required environment variables on Render:# ANTHROPIC_API_KEY → Your Claude API key# OPENAI_API_KEY → Your OpenAI API key# GEMINI_API_KEY → Your Gemini API key# JWT_SECRET → Run: openssl rand -base64 32# CORS_ALLOWED_ORIGINS → https://your-app.netlify.app# Frontend — Netlify# Drag and drop /frontend folder to Netlify# Update API_BASE in meteorium.html to point to Render URL

Docker

# Build
docker build -t prexus-kernel:latest .# Run
docker run -p 8080:8080 \
-e JWT_SECRET=your-secret-here \
-e ANTHROPIC_API_KEY=your-key \
prexus-kernel:latest
# Health check
curl localhost:8080/health


Technology Stack

TechnologyRoleVersion
GoAPI gateway, middleware, audit ledger1.22
PythonAnalytics, risk models, IPCC integration3.11+
RustMonte Carlo engine, VaR/CVaR numerics1.77+
PostgreSQLStructured API endpoints, persistence5.10+
GrafanaPredictive intelligence dashboard18
CesiumJS3D globe, geospatial visualisation1.114
Three.jsWebGL heatwave overlaysr128
CloudflareManaged cloud hosting

External Data Sources

SourceDomainCadenceIntegration
Sentinel-1 SARPhysical / Geospatial6-day revisitESA Open
ECMWFMeteorological51-member ensembleAPI adapter
IPCC-AR6 DatabaseClimate ScenariosBuilt-inBundled pathways
Terminal DatabaseFinancial Signals12 ms lagAPI adapter


Roadmap

✅ v1.4 Meteorium Engine — Physical risk scoring, Monte Carlo,
API Gateway · Meteorium UI with 3D globe
🔄 v1.5 Raksha Module — 360-degree clearance threat intelligence,
geopolitical risk modelling, sovereign operator dashboard
🔄 v1.6 Healtho Module — Population health risk engine,
bio-systemic shock propagation, epidemic modelling
⬜ v1.7 PostgreSQL Persistence — Full asset history, org workspaces,
audit-trail queryable database
⬜ v1.8 Real-time streaming — WebSocket push for live intelligence,
multi-asset portfolio event feeds
⬜ v2.0 Macro-Economic Module — Cross-domain risk correlation,
supply chain intelligence, geospatial signals


Platform Capabilities Matrix

CapabilityStatusModuleClearance
Health / Liveness Probe✅ LiveCorePublic
Organisation Registration✅ LiveCorePublic
JWT Authentication + ABAC✅ LiveCorePublic
Monte Carlo Simulation✅ LiveMeteoriumLevel 2
VaR 95% / CVaR 95%✅ LiveMeteoriumLevel 2
Tamper-Evident Audit✅ LiveCoreLevel 2
3D Climate Globe✅ LiveMeteoriumLevel 2
Meto AI (Claude / GPT-4o / Gemini)✅ LiveMeteoriumLevel 2
Portfolio Aggregation🔄 ProgressMeteoriumLevel 2
PostgreSQL Persistence🔄 ProgressCore
Raksha Threat Intelligence🔨 PlannedRakshaLevel 5
Healtho Risk Engine🔨 PlannedHealthoLevel 3
Macro-Economic Module🔨 PlannedMacroLevel 3
Geospatial Signals🔨 PlannedGeoLevel 4
Supply Chain Intelligence🔨 PlannedSupplyLevel 3
Real-time WebSocket Feed🔨 PlannedCoreLevel 2


Target Deployment Environments

SectorUse CaseKey Modules
National GovernmentClimate resilience planning, infrastructure stress testingRaksha, Geo
Central BanksSystemic climate-financial risk, portfolio exposureMeteorium, Core
Asset ManagersPortfolio-level climate VaR, regulatory disclosure (TCFD)Meteorium
Insurance / ReinsurancePhysical risk underwriting, loss modellingMeteorium
Infrastructure PlanningAsset optimisation, multi-scenario planningMeteorium, Supply
Sovereign Wealth FundsLong-horizon structural risk, geopolitical overlaysAll modules


Licensing

Prexus Intelligence operates under a dual licensing model that cleanly separates open interface from proprietary intelligence.

What is open — Apache 2.0

The user interface, design system, and frontend components of Prexus are released under the Apache 2.0 License. This includes:

  • All files under /frontend/ (HTML, CSS, JavaScript)
  • UI design tokens, component styles, layout system
  • The Meteorium globe interface and dashboard shell
  • Index, hub, landing, and demo pages

You may use, modify, and distribute these under standard Apache 2.0 terms.

What is proprietary — Prexus Intelligence Proprietary License

The backend systems, intelligence pipelines, simulation engines, and data infrastructure are proprietary to Prexus Intelligence and are not licensed for external use, reproduction, or deployment without a signed agreement. This includes:

  • /backend/ — Go API gateway, auth, audit ledger, risk proxy
  • /data-engine/ — Python intelligence layers (Layer 0–6), FastAPI endpoints
  • /data-engine/rust/ — Monte Carlo simulation engine, VaR/CVaR computation
  • All risk models, IPCC pathway integrations, scenario calibration logic
  • The Prexus intelligence architecture, scoring algorithms, and data fusion methods

Commercial licensing, institutional pilots, and sovereign deployment agreements are available. Contact: dev@prexus.in

See LICENSE (Apache 2.0) and NOTICE (Proprietary terms) for full details.




P R E X U S I N T E L L I G E N C E

Sovereign Predictive Intelligence Infrastructure

Apache 2.0 — UI/DesignProprietary — Backend/EngineClassification

For authorised institutional recipients only


© Prexus Intelligence. All rights reserved.

Releases

Packages

Contributors

Languages