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 .)

We use cookies

We use cookies to ensure you get the best experience on our website. For more information on how we use cookies, please see our cookie policy.

By clicking "Accept", you agree to our use of cookies.
Learn more.