Installation guide

Up and running in minutes

Three dependencies, one command. Here is everything you need before you run your first analysis.

1

Install Claude Code

trading-OS runs inside Claude Code — Anthropic's official CLI. If you already have it, skip ahead.

terminal
npm install -g @anthropic-ai/claude-code

Requires Node.js 18 or later. You can also download the Claude desktop app, which includes Claude Code. A Claude Pro or Max subscription is required to use Claude Code.

Verify

terminal
claude --version
2

Install Python 3

trading-OS uses Python scripts for market data fetching. Python 3.9 or later is required.

macOSbrew install python3
Ubuntu / Debiansudo apt install python3
Windowswinget install Python.Python.3

Or download the installer from python.org/downloads. Python 3 is often already installed on macOS and Linux.

Verify

terminal
python3 --version
3

Install Just

just is the command runner that exposes every trading-OS entry point as a single short command. It is the only interface you need to learn.

macOSbrew install just
Ubuntu / Debiansudo apt install just
Windowswinget install Casey.Just

Cargo and pre-built binaries are also available at github.com/casey/just.

Verify

terminal
just --version
4

Install trading-OS

After purchase you will receive an email with a zip file. Unzip it into any directory, open Claude Code there, and you are done.

terminal
unzip trading-os.zip -d trading-os
cd trading-os
claude .

No additional configuration is needed. Free market data via yfinance works out of the box. You can add premium data sources later by editing one line in the config file.

5

Run your first analysis

Inside Claude Code, type one command. Seven analysts run in parallel, the debate fires, the risk committee weighs in, and you get a clear verdict.

terminal
just decide NVDA

All entry points

just decide NVDAFull pipeline — analysts → debate → verdict → trade plan
/analysts NVDAData gathering only — seven specialists, no decision layer
/debate NVDABull vs Bear debate on existing research
/reflect NVDAReview a past call against actual price data
/journalBrowse your complete decision log

Pre-flight checklist

Claude Code installed and authenticated
Python 3.9+ available (python3 --version)
just installed (just --version)
trading-OS zip unzipped into a directory
Claude Code opened in that directory (claude .)