Run your own fleet in 5 minutes

Paper mode by default — simulates fills against live market data, moves no real funds, needs no wallet or key.

1. Clone both repos

hood-traders depends on hoodchain, which isn't on npm yet — check them out as siblings: 

git clone https://github.com/nirholas/robinhood-chain-traders.git
git clone https://github.com/nirholas/robinhood-chain-sdk.git
cd robinhood-chain-traders

2. Install and build

npm install
npm i ../robinhood-chain-sdk   # local link until hoodchain publishes
npm run build

3. Run the fleet

npm run fleet

Open http://localhost:4670 — the dashboard is live immediately: fleet equity, per-agent positions, and the decision journal streaming from real mainnet ticks.

Or: Docker, zero local Node needed

cd hood-traders
docker compose up --build

Same result. The compose file's build context is the parent directory so it can reach the sibling robinhood-chain-sdk checkout from step 1.

Try the kill switch

# any one of these halts new orders across every agent immediately
touch KILL                                    # local
curl -X POST http://localhost:4670/api/kill    # HTTP
# Ctrl-C also works

Going live

Real funds. Live mode signs and broadcasts real transactions. Only do this with a wallet you can afford to lose, after reading the strategy failure modes. 
cp .env.example .env
# edit .env:
#   HOOD_TRADERS_LIVE=1
#   ROBINHOOD_CHAIN_PRIVATE_KEY=0x...
npm run fleet

Both HOOD_TRADERS_LIVE=1 and a valid key are required — missing either keeps you in paper mode.

Tune a strategy

Edit src/main.ts — every strategy takes a params object:

import { LaunchSniper } from './strategies/launch-sniper.js'

fleet.addAgents([
  {
    id: 'sniper-conservative',
    strategy: new LaunchSniper({
      entryWeth: 0.005,
      takeProfitPct: 0.4,
      stopLossPct: 0.2,
      maxDeployerPct: 0.1,
    }),
    tickIntervalMs: 4000,
  },
])

Next

Read the architecture to understand the risk gate, or the strategy docs for every tunable and failure mode.