How grevix/kuwala works
Kuwala is a quantitative options and volatility research library. A principal workflow fetches market data through provider adapters, cleans and models option chains, derives implied volatility and surfaces, then supports pricing, arbitrage checks, and research signals. Separate capabilities include curve and forward construction, microstructure analysis, partitioned storage, backtesting, and leakage-aware validation. Numerical kernels are implemented in Python with an optional Rust core, alongside documented C++, Scala, and Julia engines. Unsampled modules are included where README or the source index establishes their roles; their internal call paths are not inferred.
Main entry points: pipeline.py Data pipeline · surface.py Volatility surface · models.py Option data models · lib.rs Rust numerical core
Components 30
Market Data
- Data pipeline
kuwala/data/pipeline.py - Yahoo adapter
kuwala/data/adapters/yahoo.py - FRED adapter
kuwala/data/adapters/fred.py - Other adapters
kuwala/data/adapters - Option data models
kuwala/data/models.py - Yield curves
kuwala/data/curves.py - Forward curves
kuwala/data/forward.py - Microstructure
kuwala/data/microstructure.py - Parquet lakehouse
kuwala/data/store.py
Pricing & Volatility
- Black pricing
kuwala/pricing/black_scholes.py - Option Greeks
kuwala/pricing/greeks.py - IV inversion
kuwala/volatility/iv.py - SSVI fitting
kuwala/volatility/ssvi.py - Volatility surface
kuwala/volatility/surface.py - Local volatility
kuwala/volatility/local_vol.py - Arbitrage diagnostics
kuwala/diagnostics/arbitrage.py - Diagnostic reports
kuwala/diagnostics/report.py
Signals & Research
- Signals & indicators
kuwala/signals - Signal validation
kuwala/signals/validation.py - Backtesting
kuwala/backtest
Numerical Engines
- Rust numerical core
kuwala_core/src/lib.rs - Rust pricing kernels
kuwala_core/src/pricing.rs - Rust Greeks
kuwala_core/src/greeks.rs - C++ pricing
kuwala_cpp/include/kuwala_cpp/pricing.hpp - C++ Greeks
kuwala_cpp/include/kuwala_cpp/greeks.hpp - Scala pricing
scala/src/main/scala/kuwala/pricing/BlackScholes.scala - Scala Greeks
scala/src/main/scala/kuwala/pricing/Greeks.scala - Arrow bridge
scala/src/main/scala/kuwala/arrow/ArrowBridge.scala
Other components
- Quant researcher
- Market sources
Connections 31
- Quant researcher → Data pipeline: requests data
README.md - Data pipeline → Yahoo adapter: dispatches
kuwala/data/pipeline.py - Data pipeline → FRED adapter: dispatches
kuwala/data/pipeline.py - Data pipeline → Other adapters: dispatches
kuwala/data/pipeline.py - Data pipeline → Option data models: uses models
kuwala/data/pipeline.py - Yahoo adapter → Market sources: fetches quotes
kuwala/data/adapters/yahoo.py - FRED adapter → Market sources: fetches data
- Data pipeline → Parquet lakehouse: stores data
README.md - Data pipeline → IV inversion: extracts IV
README.md - Option data models → Yield curves: supports curves
README.md - Option data models → Forward curves: supports forwards
README.md - Market sources → Microstructure: provides ticks
README.md - Quant researcher → Black pricing: researches options
README.md - Black pricing → Rust numerical core: uses optional core
kuwala/pricing/black_scholes.py - Option Greeks → Rust numerical core: uses optional core
kuwala/pricing/greeks.py - IV inversion → Black pricing: reprices options
kuwala/volatility/iv.py - Volatility surface → Option data models: consumes data
kuwala/volatility/surface.py - Volatility surface → IV inversion: uses inversion
kuwala/volatility/surface.py - Volatility surface → SSVI fitting: uses calibration
kuwala/volatility/surface.py - Volatility surface → Local volatility: extracts local vol
kuwala/volatility/surface.py - Volatility surface → Arbitrage diagnostics: checks arbitrage
kuwala/volatility/surface.py - Volatility surface → Option Greeks: calculates Greeks
kuwala/volatility/surface.py - Arbitrage diagnostics → Diagnostic reports: builds reports
kuwala/diagnostics/arbitrage.py - Quant researcher → Signals & indicators: develops signals
README.md - Signals & indicators → Signal validation: validates signals
README.md - Signals & indicators → Backtesting: tests strategies
README.md - Rust numerical core → Rust pricing kernels: exports kernels
kuwala_core/src/lib.rs - Rust numerical core → Rust Greeks: exports kernels
kuwala_core/src/lib.rs - Rust Greeks → Rust pricing kernels: calls pricing
kuwala_core/src/greeks.rs - Scala Greeks → Scala pricing: uses pricing
scala/src/main/scala/kuwala/pricing/Greeks.scala - Arrow bridge → Option data models: maps quotes
README.md