Skip to content

Repository files navigation

Atlas

A Living Digital Twin of the Global Financial System

Atlas is an interactive simulation platform that models how money moves through the global financial system. It simulates banks, clearinghouses, central banks, and payment networks — running real financial protocols — with chaos engineering, crisis replay, systemic risk analysis, and a custom regulatory DSL.

Live Demo — No signup. No paid APIs. Runs in your browser.

Quick Start

npm install
npm run dev
# Open http://localhost:3000

That's it. No Docker. No database servers. No API keys. Everything runs locally.

What You Can Do

Launch a Simulation

Start a pre-configured global financial network with 15 institutions (3 central banks, 4 G-SIBs, 4 major banks, 2 regional banks, 2 clearinghouses). Watch autonomous agents make lending, trading, and risk management decisions in real time.

Inject Chaos

Five failure types with distinct mechanics:

Type Scope Effect
Institution Failure Single target Kills institution to near-zero health
Liquidity Shock Target + connections Drains target, freezes lending to connected banks
Deposit Run Cascading (2 waves) Spreads from target to connections, then to their connections
Market Shock System-wide All institutions hit, larger banks hit harder
Confidence Shock System-wide All institutions hit, weaker banks hit hardest

Preset scenarios: Lehman Moment, SVB Run, Flash Crash.

Replay Historical Crises

Relive the Lehman Brothers collapse (2008), SVB bank run (2023), Flash Crash (2010), LTCM meltdown (1998), or Treasury market seizure (2020). Educational annotations explain what's happening. Branch the timeline with counterfactual "what if" scenarios.

Write Regulatory Rules

Atlas includes a custom domain-specific language (DSL) for financial regulations:

RULE "CET1 Capital Ratio" {
  FOR EACH bank IN institutions WHERE bank.type == "commercial_bank"
  REQUIRE bank.capitalAdequacy >= 0.045
  ELSE TRIGGER "capital_breach" WITH severity = "critical"
}

Compile in <50ms. Hot-reload into the running simulation. See violations update in real time.

Analyze Systemic Risk

Three analysis tools on the Topology page:

  • Topology Stats — Centrality rankings, minimum failure sets, Monte Carlo resilience scoring, risk community detection
  • Risk Heatmap — Interactive bilateral exposure matrix with type filtering and row/column crosshair
  • Failure Simulator — Batch what-if scenarios with multi-institution selection and impact narratives

Architecture

┌─────────────────────────────────────────────────────────┐
│              LAYER 4 — EXPERIENCE                        │
│  Observatory  │  War Room  │  Crisis Replay │  DSL Editor│
├─────────────────────────────────────────────────────────┤
│              LAYER 3 — INTELLIGENCE                      │
│  Behavioral Agents  │  Risk Topology  │  Regulatory DSL  │
├─────────────────────────────────────────────────────────┤
│              LAYER 2 — SIMULATION                        │
│  DES Engine  │  RTGS  │  ACH  │  SWIFT  │  CLS  │  DTCC │
├─────────────────────────────────────────────────────────┤
│              LAYER 1 — DATA                              │
│  ECB/FRED (Free)  │  Crisis DB  │  Regulatory KB         │
└─────────────────────────────────────────────────────────┘

Turborepo monorepo with 8 TypeScript packages + 1 Next.js app. Zero paid APIs. Fully offline-capable.

Tech Stack

  • Frontend: Next.js 14, TypeScript, D3.js, Canvas (rotating globe with Natural Earth data), Framer Motion
  • Backend: Node.js, SQLite (better-sqlite3), Socket.io
  • Custom: Hand-written regulatory DSL compiler (lexer → parser → AST → constraint compiler)
  • Deployment: Vercel

Financial Protocols

Protocol Real-World System What It Does
RTGS FedWire Real-time gross settlement with gridlock detection
ACH Automated Clearing House Batch processing with multilateral netting
SWIFT SWIFT Network Message routing through correspondent banking
CLS CLS Bank Payment-vs-payment FX settlement
DTCC DTCC/NSCC Securities clearing with novation and T+1 settlement

Project Structure

atlas/
├── apps/web/              # Next.js frontend + API + WebSocket server
├── packages/
│   ├── shared/            # Core types, constants, utilities
│   ├── simulation-core/   # Discrete event simulation engine (Immer)
│   ├── protocols/         # 5 financial protocol implementations
│   ├── agents/            # Behavioral agent engine with personality profiles
│   ├── risk-topology/     # Graph-based systemic risk analysis
│   ├── regulatory-dsl/    # Custom DSL compiler + runtime
│   ├── crisis-engine/     # Historical crisis replay + counterfactual branching
│   └── market-data/       # Free market data fetchers (ECB, FRED)
├── scripts/               # Build utilities (globe path generation)
├── vercel.json            # Deployment config
└── package.json

Commands

npm run dev          # Dev server on :3000
npm run build        # Build all packages via Turborepo
npm run test         # Run all 478 tests via Vitest
npm run lint         # Lint all packages
vercel deploy --prod # Deploy to Vercel

License

MIT

About

Interactive digital twin of the global financial system: autonomous agents, real payment rails (RTGS/ACH/SWIFT/CLS/DTCC), systemic-risk analysis, crisis replay & a custom regulatory DSL. TypeScript monorepo, 478 tests.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages