How muhammadmoaz/risk-regime-engine works
This repository is a single-script BTC risk-regime analysis prototype. Its current workflow fetches BTC history from Yahoo Finance, derives returns and volatility features, classifies regimes, compares forward returns by regime, assigns risk signals, and prints the latest result; it also produces plots and backtests a signal strategy. The README describes future up/flat/down probabilities and a web page, but those capabilities are not evidenced in the sampled implementation. All implementation nodes therefore point to main.py; connections reflect the excerpt, not unsampled code.
Main entry points: main.py Signal Scoring · Plots Saved Plots
Components 14
Market Analysis
- Analysis Run
main.py - BTC History
main.py - Return Features
main.py
Regime Signals
- Volatility Regimes
main.py - Trend Regimes
main.py - Signal Scoring
main.py
Evaluation
- Forward Returns
main.py - Regime Statistics
main.py - Strategy Backtest
main.py - Performance Stats
main.py
Outputs
- Latest Signal
main.py - Saved Plots
Plots
Other components
- User
- Yahoo Finance
Connections 16
- User → Analysis Run: runs
main.py - Analysis Run → Yahoo Finance: fetches history
main.py - Analysis Run → BTC History: loads BTC data
main.py - BTC History → Return Features: derives returns
main.py - Return Features → Volatility Regimes: measures volatility
main.py - Return Features → Trend Regimes: classifies trend
main.py - Trend Regimes → Forward Returns: computes horizons
main.py - Forward Returns → Regime Statistics: groups by regime
main.py - Regime Statistics → Signal Scoring: scores regimes
main.py - Signal Scoring → Latest Signal: maps latest signal
main.py - Signal Scoring → Strategy Backtest: sets positions
main.py - Strategy Backtest → Performance Stats: computes metrics
main.py - Volatility Regimes → Saved Plots: saves charts
main.py - Trend Regimes → Saved Plots: saves regime chart
main.py - Signal Scoring → Saved Plots: saves signal chart
main.py - Strategy Backtest → Saved Plots: saves equity chart
main.py