How rajmaurya0904/kronos-options works
Kronos Options Signal System turns index-market data into probabilistic forecasts, directional signals, and option recommendations, then evaluates them through historical backtests or simulated live trading; a separately documented, safety-locked real-order path is also present. Data collection, cleaning, modeling, signal classification, and option mapping are distinct stages. Backtester and PaperTrader orchestrate the stages; SQLite supports stored results and the dashboard presents them. The README supplies the main workflow and capabilities; some subsystem links reflect that documentation because their source was not sampled.
Main entry points: paper_trader.py Paper Trader · backtester.py Walk-Forward Backtester · base.py Broker Interface · db.py SQLite Store
Components 17
Market Data & Forecasting
- Data Fetcher
src/data_fetcher.py - Data Cleaner
src/data_cleaner.py - Kronos Forecaster
src/forecaster.py - Broker Interface
src/broker/base.py - Upstox Broker
src/broker/upstox.py - Zerodha Stub
src/broker/zerodha.py
Signals & Options
- Signal Engine
src/signal_engine.py - Options Mapper
src/options_mapper.py
Trading & Evaluation
- Walk-Forward Backtester
src/backtester.py - Paper Trader
src/paper_trader.py - Live Trader
src/live_trader.py
Persistence & Dashboard
- SQLite Store
src/db.py - Streamlit Dashboard
dashboard/app.py
Other components
- Operator
- Upstox API
- Kronos Model
- Desktop Notifications
Connections 28
- Operator → Paper Trader: starts loop
- Operator → Walk-Forward Backtester: runs backtest
- Operator → Streamlit Dashboard: views results
- Data Fetcher → Broker Interface: requests candles
- Broker Interface → Upstox Broker: implemented by
- Broker Interface → Zerodha Stub: stub alternative
- Upstox Broker → Upstox API: requests market data
- Data Fetcher → Data Cleaner: provides bars
- Kronos Forecaster → Kronos Model: runs predictions
- Paper Trader → Data Fetcher: fetches bars
- Paper Trader → Data Cleaner: cleans bars
- Paper Trader → Kronos Forecaster: forecasts prices
- Paper Trader → Signal Engine: generates signal
- Paper Trader → Options Mapper: maps recommendation
- Paper Trader → Broker Interface: gets option chain
- Paper Trader → SQLite Store: logs paper trades
- Paper Trader → Desktop Notifications: sends alerts
- Walk-Forward Backtester → Data Fetcher: fetches history
- Walk-Forward Backtester → Kronos Forecaster: forecasts bars
- Walk-Forward Backtester → Signal Engine: generates signals
- Walk-Forward Backtester → Options Mapper: maps trades
- Walk-Forward Backtester → Broker Interface: requests option data
- Walk-Forward Backtester → SQLite Store: saves run results
- Live Trader → Broker Interface: places real orders
- Signal Engine → SQLite Store: saves signals
- Kronos Forecaster → SQLite Store: saves forecasts
- Options Mapper → Broker Interface: fetches option chain
- Streamlit Dashboard → SQLite Store: reads forecasts and trades