# gytt65/omega-live-option-chain-finale-v10 architecture

> Architecture diagram of the GitHub repository gytt65/omega-live-option-chain-finale-v10, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gytt65/omega-live-option-chain-finale-v10
- Repository: https://github.com/gytt65/omega-live-option-chain-finale-v10

## Overview

OMEGA NOVA is a manual decision-support system for Nifty options: market inputs are analyzed by its pricing pipeline, then surfaced as valuation and actionability guidance rather than automatic orders. Its principal workflow combines market context, volatility and jump modeling, option valuation, and risk-aware decision output. Separate capabilities include AI Council analysis and paper-trade tracking. The README documents the wider pipeline; sampled excerpts confirm selected orchestration, behavioral, council, and risk components, so unsampled internal wiring is shown only where documented.

Main entry points: [`unified_pipeline.py`](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/unified_pipeline.py) (NOVA Pipeline), [`opmAI_app.py`](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/opmAI_app.py) (Trading Interface), [`ai_council/orchestrator.py`](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/ai_council/orchestrator.py) (Council Orchestrator), [`omega_model.py`](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/omega_model.py) (OMEGA Intelligence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Decision Support"]
  node_app_ui["Trading Interface<br/>[opmAI_app.py]"]
  node_data["Data Providers<br/>[data_providers.py]"]
  node_behavior["Market State"]
  node_omega["OMEGA Intelligence<br/>[omega_model.py]"]
  node_execution["Actionability Analysis"]
end

subgraph group_pricing["Pricing Pipeline"]
  node_pipeline["NOVA Pipeline"]
  node_quant["Quant Engine<br/>[quant_engine.py]"]
  node_surface["Volatility Surface"]
  node_jumps["Jump Dynamics<br/>[hawkes_jump.py]"]
  node_jsde["Neural Arbitrage<br/>[neural_jsde.py]"]
  node_nirv["NIRV Valuation<br/>[nirv_model.py]"]
  node_hedging["Deep Hedging<br/>[deep_hedging.py]"]
end

subgraph group_council["AI Council"]
  node_council_worker["Council Worker<br/>[worker.py]"]
  node_council["Council Orchestrator<br/>[orchestrator.py]"]
  node_events["Event Ingestion<br/>[event_ingestion.py]"]
  node_agents["Council Agents<br/>[agents.py]"]
  node_memory[("Reliability Memory<br/>[memory_store.py]")]
end

subgraph group_trading["Trade Review"]
  node_paper[("Paper Trade Log<br/>[paper_trader.py]")]
  node_safeguards["Risk Safeguards<br/>[safeguards.py]"]
end

node_trader(("Options User"))
node_market(("Market Data"))
node_upstox(("Upstox API"))

node_trader -->|"requests analysis"| node_app_ui
node_market -->|"market inputs"| node_data
node_upstox -.->|"provides data"| node_data
node_app_ui -->|"obtains inputs"| node_data
node_app_ui -->|"builds context"| node_behavior
node_app_ui -->|"requests analysis"| node_omega
node_omega -->|"runs pricing"| node_pipeline
node_pipeline -->|"uses quant methods"| node_quant
node_pipeline -->|"models surface"| node_surface
node_pipeline -->|"estimates jumps"| node_jumps
node_pipeline -->|"models dynamics"| node_jsde
node_pipeline -->|"values options"| node_nirv
node_pipeline -->|"computes hedges"| node_hedging
node_omega -->|"scores actionability"| node_execution
node_app_ui -->|"records trades"| node_paper
node_app_ui -->|"checks risk"| node_safeguards
node_council_worker -->|"runs cycles"| node_council
node_council_worker -->|"loads agents"| node_agents
node_council -->|"scores events"| node_events
node_council -->|"reads reliability"| node_memory
node_council -->|"updates calibration"| node_memory

click node_app_ui "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/opmAI_app.py"
click node_data "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/data_providers.py"
click node_behavior "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/behavioral_state_engine.py"
click node_omega "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/omega_model.py"
click node_pipeline "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/unified_pipeline.py"
click node_quant "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/quant_engine.py"
click node_surface "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/pinn_vol_surface.py"
click node_jumps "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/hawkes_jump.py"
click node_jsde "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/neural_jsde.py"
click node_nirv "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/nirv_model.py"
click node_hedging "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/deep_hedging.py"
click node_execution "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/omega2_execution_engine.py"
click node_council_worker "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/ai_council/worker.py"
click node_council "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/ai_council/orchestrator.py"
click node_events "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/ai_council/event_ingestion.py"
click node_agents "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/ai_council/agents.py"
click node_memory "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/ai_council/memory_store.py"
click node_paper "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/prod/paper_trader.py"
click node_safeguards "https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/prod/safeguards.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app_ui,node_data,node_behavior,node_omega,node_execution,node_trader toneBlue
class node_pipeline,node_quant,node_surface,node_jumps,node_jsde,node_nirv,node_hedging toneAmber
class node_council_worker,node_council,node_events,node_agents,node_memory,node_upstox toneMint
class node_paper,node_safeguards toneRose
class node_market toneIndigo
```

## Components

### Decision Support

- [Trading Interface](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/opmAI_app.py): `opmAI_app.py`
- [Data Providers](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/data_providers.py): `data_providers.py`
- [Market State](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/behavioral_state_engine.py): `behavioral_state_engine.py`
- [OMEGA Intelligence](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/omega_model.py): `omega_model.py`
- [Actionability Analysis](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/omega2_execution_engine.py): `omega2_execution_engine.py`

### Pricing Pipeline

- [NOVA Pipeline](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/unified_pipeline.py): `unified_pipeline.py`
- [Quant Engine](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/quant_engine.py): `quant_engine.py`
- [Volatility Surface](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/pinn_vol_surface.py): `pinn_vol_surface.py`
- [Jump Dynamics](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/hawkes_jump.py): `hawkes_jump.py`
- [Neural Arbitrage](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/neural_jsde.py): `neural_jsde.py`
- [NIRV Valuation](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/nirv_model.py): `nirv_model.py`
- [Deep Hedging](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/deep_hedging.py): `deep_hedging.py`

### AI Council

- [Council Worker](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/ai_council/worker.py): `ai_council/worker.py`
- [Council Orchestrator](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/ai_council/orchestrator.py): `ai_council/orchestrator.py`
- [Event Ingestion](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/ai_council/event_ingestion.py): `ai_council/event_ingestion.py`
- [Council Agents](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/ai_council/agents.py): `ai_council/agents.py`
- [Reliability Memory](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/ai_council/memory_store.py): `ai_council/memory_store.py`

### Trade Review

- [Paper Trade Log](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/prod/paper_trader.py): `prod/paper_trader.py`
- [Risk Safeguards](https://github.com/gytt65/omega-live-option-chain-finale-v10/blob/main/prod/safeguards.py): `prod/safeguards.py`

### Other components

- **Options User**
- **Market Data**
- **Upstox API**

## Connections

- Options User → Trading Interface: requests analysis
- Market Data → Data Providers: market inputs
- Upstox API → Data Providers: provides data
- Trading Interface → Data Providers: obtains inputs
- Trading Interface → Market State: builds context
- Trading Interface → OMEGA Intelligence: requests analysis
- OMEGA Intelligence → NOVA Pipeline: runs pricing
- NOVA Pipeline → Quant Engine: uses quant methods
- NOVA Pipeline → Volatility Surface: models surface
- NOVA Pipeline → Jump Dynamics: estimates jumps
- NOVA Pipeline → Neural Arbitrage: models dynamics
- NOVA Pipeline → NIRV Valuation: values options
- NOVA Pipeline → Deep Hedging: computes hedges
- OMEGA Intelligence → Actionability Analysis: scores actionability
- Trading Interface → Paper Trade Log: records trades
- Trading Interface → Risk Safeguards: checks risk
- Council Worker → Council Orchestrator: runs cycles
- Council Worker → Council Agents: loads agents
- Council Orchestrator → Event Ingestion: scores events
- Council Orchestrator → Reliability Memory: reads reliability
- Council Orchestrator → Reliability Memory: updates calibration