How vijish18/godzilla works
GodZilla is a research-first intraday quantitative trading platform for liquid NSE instruments. Its documented workflow runs from market observations through causal features and market-state routing to independent alpha strategies, ensemble normalization, and proposed portfolio targets. Supporting capabilities include universe construction, compliance and session metadata, and durable event replay. The README describes risk approval and execution as required future stages, but explicitly says they are not implemented; they are therefore not represented as runtime components. Edges cite README workflow statements or source-index references; unsampled subsystems are included only where the README documents them.
Main entry points: engine.py Feature Engine · cli.py CLI · journal.py Event Journal · service.py Market Data Service
Components 20
Market Inputs
- NSE Calendar
src/godzilla/market_data/calendar.py - Instrument Master
src/godzilla/market_data/instruments.py - Universe Builder
src/godzilla/universe/builder.py - Market Data Service
src/godzilla/market_data/service.py - Data Quality
src/godzilla/market_data/quality.py
Features and Signals
- Feature Engine
src/godzilla/features/engine.py - Feature Publication
src/godzilla/features/service.py - Market-State Router
src/godzilla/market_state/router.py - Momentum Alpha
src/godzilla/alphas/momentum_research.py - Pairs Research
src/godzilla/alphas/pairs_engine.py - Other Alpha Strategies
src/godzilla/alphas
Alpha Allocation
- Alpha Ensemble
src/godzilla/ensemble/normalize.py - Portfolio Allocator
src/godzilla/portfolio/allocator.py
Operations
- CLI
src/godzilla/app/cli.py - Configuration
src/godzilla/config/loader.py - Compliance Profiles
src/godzilla/compliance/service.py
Events and Storage
- Event Journal
src/godzilla/core/events/journal.py - Event Replay
src/godzilla/core/events/replay.py - PostgreSQL Storage
src/godzilla/storage/postgres.py
Other components
- Operator
Connections 25
- Operator → CLI: invokes
src/godzilla/app/cli.py - CLI → Configuration: loads
src/godzilla/app/cli.py - CLI → Compliance Profiles: validates
src/godzilla/app/cli.py - CLI → Instrument Master: loads
src/godzilla/app/cli.py - CLI → Universe Builder: builds
src/godzilla/app/cli.py - Universe Builder → Instrument Master: uses
src/godzilla/universe/builder.py - Market Data Service → Data Quality: checks observations
src/godzilla/market_data/service.py - Market Data Service → NSE Calendar: uses sessions
- Market Data Service → Feature Engine: provides observations
README.md - Feature Engine → Market-State Router: provides features
README.md - Feature Engine → NSE Calendar: uses sessions
src/godzilla/features/engine.py - Feature Publication → Event Journal: publishes events
src/godzilla/features/service.py - Market-State Router → Momentum Alpha: routes permissions
src/godzilla/alphas/momentum_research.py - Market-State Router → Pairs Research: supplies state
src/godzilla/alphas/pairs_engine.py - Market-State Router → Other Alpha Strategies: routes permissions
README.md - Feature Engine → Momentum Alpha: supplies features
src/godzilla/alphas/momentum_research.py - Feature Engine → Pairs Research: supplies features
src/godzilla/alphas/pairs_engine.py - Momentum Alpha → Alpha Ensemble: supplies candidates
README.md - Pairs Research → Alpha Ensemble: supplies candidates
README.md - Other Alpha Strategies → Alpha Ensemble: supplies candidates
README.md - Alpha Ensemble → Portfolio Allocator: provides decisions
README.md - Portfolio Allocator → Event Journal: publishes decisions
- Market Data Service → Event Journal: records events
README.md - Event Journal → PostgreSQL Storage: persists through
src/godzilla/core/events/journal.py - Event Replay → Event Journal: replays events
README.md