Stock Review 2.3 · pick · run · read

Stock Review

Pick a list of stocks: the ASX 200, the S&P 500, all of Japan, or your own tickers. Click Run. Stock Review pulls the latest numbers from Yahoo Finance and writes them into one tidy report that you can drop into any AI chat.

Free and Windows-only. Everything runs on your own computer. There's no AI inside the app.

⬇ Download for Windows View source on GitHub How to install

Windows 10/11 · free · ~40 MB · portable zip (no install) · all versions

MS-DOS Prompt - STOCK REVIEW

C:\STOCKS> stock_review --source australia

                    *            .        +          .
          .                 ___                 *
                 +         /   \      to the moon...
                          | o o |
      .                   |  ^  |        .            +
                         /|_____|\
                        /_|  |  |_\         *
                          |__|__|
                          / \/ \
                         / /\ \ \      .
                          '.''.'

 [████████████████████░░░░░░░░░░]  134/200  67%   ETA 1:12
 tape: BHP.AX ✓  CBA.AX ✓  CSL.AX ✓  » WES.AX  NAB.AX ✓  ✗ XYZ.AX

Fetching… 131 ok, 3 failed, 1 retry0:02:4116:30

What it does

One run gives you one file to hand to an AI

1. Pick

Regions: S&P 500/400/600/1500, ASX 200, every ASX listing, Japan, UK, Germany, Hong Kong, Canada, India, plus small-cap sleeves and global combos
Sectors: energy, mining, telecom, tech, financials, healthcare and more, optionally limited to one region
Your own list: type tickers (AAPL BHP.AX 7203.T) or load a .txt or .csv file

2. Fetch

For each company: size (in USD), valuation (P/E, PEG, P/B, P/S), quality (ROE, margin, growth, debt), dividends
Momentum: 1, 3, 6 and 12-month returns, distance from the 50- and 200-day averages, and from the 52-week high and low
Analyst rating, price target and upside

3. Read

You get one date-stamped report. The default Markdown version is a compact table with a column legend and built-in instructions for the AI that will read it. You can also export CSV for Excel or JSON for scripts.

Ticker,Name,Sector,Price,MktCapB,PE,FwdPE,ROE,RevGr,Div,1y,vs200d,Analyst,Upside AAPL,Apple,Tech,227.5,3450,34.6,29.8,157.4,6.1,0.4,18.2,4.9,B,8.3 BHP.AX,BHP Group,Mat,41.2,141,16.9,12.4,19.8,-2.5,4.9,-6.0,-3.1,H,7.5 7203.T,Toyota Motor,ConsDisc,2710,236,7.8,8.9,13.1,7.3,3.1,-9.4,-5.2,B,21.0

Example rows for illustration only, not real quotes. A blank cell means Yahoo didn't have the value. The app never guesses one.

Install

Install in about a minute

Download Stock-Review-Setup.exe.
Open it. If you see a blue "Windows protected your PC" box, click More info, then Run anyway. This only means the app is new to Windows. You'll only see it once.
Click Next → Install → Finish. You don't need an admin password or Python.
Open Stock Review from your desktop, pick something from Quick picks, click ▶ Run review, then click Open report.

⬇ Download Stock-Review-Setup.exe

💡 Tip of the Day: Yahoo limits how fast you can pull data on big runs. If some tickers say FAIL, wait a few minutes and run the same thing again. It picks up where it left off and fills in the gaps.

Reports are saved to Documents\Stock Review\reports.

Run from source (any OS)

git clone https://github.com/nxt549/stock-review cd stock-review pip install -r requirements.txt python stock_review_gui.py # the window python stock_review.py --source japan # the command line python stock_review.py --list-groups # every region and sector

The honesty rule

It never makes up a number

If…	Stock Review…
Yahoo doesn't have a value	leaves the cell blank (or shows `n/a` in rich mode). It never fills in 0 or a guess.
A ticker can't be fetched	lists it in a "could not fetch" section instead of quietly dropping it
Yahoo rate-limits you	retries politely with growing pauses, shows each retry, and saves its progress so a rerun resumes
You click Cancel	still writes everything fetched so far as a clearly marked partial report
A ticker doesn't really belong in the sector you picked	removes it and lists it, along with the industry that ruled it out

The app only connects to Yahoo Finance. There are no accounts and no telemetry.

Little luxuries

Built like a proper 90s program

13 ASCII-art channels play while it works (rocket, whale, bank vault, harbour…). Double-click the DOS title bar to switch.
Quick picks, tooltips, Recent reports, Tip of the Day, a Crystal Ball (Ctrl+8) and a lifetime odometer
A Terminal edition that runs the same engine with command-line flags and the animations in your console
For developers, the repo also includes a deterministic 0–100 scoring pipeline with a backtest harness. See the README.

⚠ Important

Not financial advice. Stock Review is an automated research screen that gathers numbers into a tidy file. Yahoo Finance data can be wrong, delayed or missing, so check it before you act on anything. Decisions are yours (and ideally a licensed adviser's).

Made for fun by NXT.