A global market regime checklist covering 24 indexes and currency indexes across Americas, Europe, and Asia — plus 10 US sectors. The CLI and Streamlit UI also offer bonds/rates, futures, and FX presets (fixed Yahoo ticker lists).

This project does not try to predict the future. It gives you a clean, objective checklist so you can see whether market conditions look healthy, weak, or mixed — across the world, not just the US.

Welcome! If this is your first time opening this project, follow these steps in order.

• On Mac: press Cmd + Space, type Terminal, hit Enter
• You should see a blinking cursor — this is where you type commands

cd ~/technical-regime

This moves you into the project directory. Think of it like opening a folder on your desktop.

Recommended on Mac (avoids “permission denied” on system Python): use a virtual environment inside this folder.

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Shortcut: from the project root, run ./scripts/init.sh once (creates .venv and installs requirements.txt).

You only create .venv once. Later, open a new terminal, cd to the project, then run source .venv/bin/activate before cli.py or Streamlit.

Alternative: install into your user Python (may need pip3):

pip install -r requirements.txt

This installs yfinance (market data), pandas (tables), and Streamlit (web UI).

python3 cli.py

That's it. You'll see a global market health report grouped by region. It takes a few seconds because it's downloading live market data.

To run your own stock tickers (comma-separated) instead:

python3 cli.py --tickers AAOI,TSLA,AAPL

Preset universes (pick one in the CLI — they cannot be combined with each other or with --tickers; the Streamlit sidebar works the same way):

python3 cli.py --sectors
python3 cli.py --bonds
python3 cli.py --futures
python3 cli.py --currencies

Exact symbol lists live in regime/data.py (BOND_TICKERS, FUTURES_TICKERS, CURRENCY_TICKERS). Human-readable labels are in regime/report.py (TICKER_NAMES).

With your venv activated (see Step 3), run:

streamlit run app.py --server.address localhost

Or without activating: .venv/bin/streamlit run app.py --server.address localhost

Open http://localhost:8501 in your browser (Streamlit prints the URL). Use the sidebar for Global indexes, US sectors, Bonds / rates, Futures, Currencies, or Custom, and Refresh data to bypass the ~2 minute cache and pull Yahoo again. The dev server uses localhost only (see .streamlit/config.toml).

To use your own stock tickers in the UI:

• Sidebar → Universe → Custom
• Enter tickers like: AAOI, TSLA, AAPL

For each ticker you'll see 5 lines:

1. Ticker + Close price — what it is and where it's trading
2. MA line — is price above or below each moving average, and is each MA rising (↑) or falling (↓)?
3. Levels line — how far price is from key reference points (ATH, recent high, swing highs/lows)
4. Trend line — is the market making higher highs (stairs up) or lower lows (stairs down)?
5. Regime line — the overall verdict (BULLISH / BEARISH / NEUTRAL) and what drove it

Then at the end of each region you'll see a Summary listing every ticker's verdict, plus overall counts and average score.

python3 -m pytest -q

This runs all the automated checks to make sure the code is working correctly. If you see all tests pass, everything is good.

Americas (python3 cli.py):

Europe (python3 cli.py):

Asia (python3 cli.py):

US Sectors (python3 cli.py --sectors):

Bonds / rates (python3 cli.py --bonds):

Futures (python3 cli.py --futures): metals, energy, equity indices, rates, grains, livestock, and softs (30+ continuous contracts). The futures preset includes some rates futures (like ZN=F / ZT=F) that also appear in the Bonds / rates preset; the symbol lists are defined separately. See FUTURES_TICKERS in regime/data.py.

Currencies (python3 cli.py --currencies): 23 FX pairs (majors, crosses, and USD vs EM). See CURRENCY_TICKERS in regime/data.py.

Tip: Some futures or thin FX symbols may show as skipped if Yahoo returns fewer than ~200 daily bars — the rest of the report still runs. Also, a few continuous futures symbols (example: B0=F) may occasionally return no data from Yahoo; that will also show as “skipped”.

• All tickers BULLISH — Market looks broadly healthy globally
• All tickers BEARISH — Market looks broadly weak globally
• Mixed — Normal. Different regions and markets don't always agree.

• "No module named 'yfinance'" — Run pip install -r requirements.txt again
• "No data returned for X" — Your internet might be down, or the market data service is temporarily unavailable. Try again in a minute.
• A ticker says "skipped" — Fetch failed or not enough history (the tool needs about 200 trading days of daily data per symbol). The rest of the report still runs.

Think of this tool like two things at once:

• Weather check before leaving the house
• Doctor checkup for market health

• Is price above or below key moving averages?
• Above = warmer/healthier
• Below = colder/weaker

• Is each moving average rising or falling?
• Rising (↑) = trend gaining strength
• Falling (↓) = trend losing strength

• Are highs and lows getting higher? → stairs up (UPTREND)
• Are highs and lows getting lower? → stairs down (DOWNTREND)
• Mixed pattern? → choppy/noisy market

• Close to ATH or recent high = bullish
• Far below recent high = bearish
• Well above prior swing low = healthy
• At or below prior swing low = warning sign

Each ticker gets 4 checks, each scored bullish, neutral, or bearish:

Net score = bullish checks − bearish checks

• Net ≥ +2 → BULLISH
• Net ≤ −2 → BEARISH
• Otherwise → NEUTRAL

Contradiction guard: if MA and Trend directly contradict each other, the ticker is forced NEUTRAL regardless of score.

^GSPC  (S&P 500)  Close: 6418.37
  MA:      10d BELOW↓  20d BELOW↓  50d BELOW↓  100d BELOW↓  200d BELOW↑  (+0/-5 pos, +1/-4 slope)
  Levels:  ATH -8.3%  RHigh -8.3%  SHigh -8.2%  SLow -5.3%  PSLow -5.3%
  Trend:   DOWNTREND (LH/LL)
  Regime:  BEARISH  +0/-4 (net -4)  MA=bearish  Trend=bearish  RHigh=bearish  PSLow=bearish

How to read this:

• 10d BELOW↓ → price is below the 10-day MA, and that MA is falling — double bearish
• 200d BELOW↑ → price is below the 200-day MA, but at least that MA is still rising — mixed
• +0/-5 pos → below all 5 moving averages
• +1/-4 slope → 4 of 5 MAs are falling
• ATH -8.3% → price is 8.3% below its all-time high
• PSLow -5.3% → price has already broken below the prior significant swing low — bearish signal
• Regime: BEARISH → all 4 checks agree bearish, net score −4

^BVSP  (Bovespa Index)  Close: 182803.27
  MA:      10d ABOVE↑  20d ABOVE↓  50d ABOVE↑  100d ABOVE↑  200d ABOVE↑  (+5/-0 pos, +4/-1 slope)
  Levels:  ATH -5.1%  RHigh -5.1%  SHigh -5.1%  SLow +16.9%  PSLow +17.8%
  Trend:   UPTREND (HH/HL)
  Regime:  BULLISH  +3/-0 (net +3)  MA=bullish  Trend=bullish  RHigh=neutral  PSLow=bullish

How to read this:

• +5/-0 pos → above all 5 MAs
• +4/-1 slope → 4 of 5 MAs still rising
• PSLow +17.8% → price is 17.8% above the prior swing low — a lot of cushion
• Trend: UPTREND (HH/HL) → staircase still going up
• Regime: BULLISH → 3 of 4 checks bullish, net score +3

A "regime conflict" is when the checks disagree. This is common and does not mean something is broken — it means the market is sending mixed signals.

Count the agreements, not just the disagreements.

• 4/4 agree = cleanest possible signal
• 3/4 agree = leaning one way, but treat as cautious
• 2/4 agree = no clear regime, reduce conviction

When in doubt, give more weight to the longer timeframe signals:

• 200-day MA position > 10-day MA position
• Trend structure > short-term slope direction

Short-term signals flip often. Longer signals change slowly and carry more weight.

technical-regime/
  cli.py               # terminal report
  app.py               # Streamlit web UI (localhost)
  scripts/init.sh      # one-shot venv + pip install (optional)
  requirements.txt     # yfinance, pandas, streamlit
  regime/
    data.py            # fetch + validate OHLC
    indicators.py      # MAs, trend, levels, regime scoring
    report.py          # build_regime_report() — shared by CLI + UI
  test_indicators.py   # automated tests
  .streamlit/config.toml   # bind Streamlit to localhost

./scripts/init.sh                 # optional: creates .venv + installs deps (or follow Step 3 manually)
source .venv/bin/activate         # each new terminal
python3 cli.py                    # global indexes (default)
python3 cli.py --sectors          # US sectors
python3 cli.py --bonds            # rates / Treasury
python3 cli.py --futures          # futures universe
python3 cli.py --currencies       # FX universe
python3 cli.py --tickers AAPL,MSFT   # custom list (cannot mix with presets above)
streamlit run app.py --server.address localhost   # web UI → http://localhost:8501
python3 -m pytest -q              # run all tests

Each trading day, run these four steps in order:

# 1. Pull latest code
git pull

# 2. Run global index report
source .venv/bin/activate
python3 cli.py

# 3. Run US sector report (and any other presets you care about)
python3 cli.py --sectors
# python3 cli.py --bonds
# python3 cli.py --futures
# python3 cli.py --currencies

# 4. Save today's brief
# Create briefs/YYYY-MM-DD.md with verdicts, scores, and gameplan

Briefs are saved as briefs/YYYY-MM-DD.md — one file per day, building a historical record you can look back on.

• This is a checklist tool, not financial advice.
• It is designed for clarity first, complexity later.
• If a ticker fails to fetch data, it is skipped automatically — the rest of the report still runs.

• Shorter “brief” CLI mode (one line per ticker / region) alongside the full report
• Historical regime tracking (save daily snapshots)
• Multi-timeframe analysis (weekly + daily)
• Sector rotation signals
• Export to CSV or simple dashboard

Global market regime dashboard: 24 indexes across Americas, Europe, and Asia, plus optional sectors, bonds/rates, futures, and FX presets — each ticker scored on MA position, MA slope, trend structure, and key levels (CLI uses green/red/yellow; Streamlit color-codes tables).