Quickstart

This guide gets you from zero to paper trading in under 10 minutes.

Step 1: Install

npm install -g edgeproof

Step 2: Configure

edgeproof init

Answer the wizard's prompts. For a quick start:

• LLM: choose Ollama if you have it running (ollama pull gemma4 if not)
• Alpaca: use your paper account keys. Paper trading is always free
• Discord: paste the URL of a signal channel you want to monitor

Step 3: Start

edgeproof start

EdgeProof spawns four processes:

• monitor: reads Discord signals, extracts trades via LLM, executes through guardrails
• positions: polls open positions, fires stop-loss / take-profit / trailing-stop exits
• ledger: records P&L and serves the local dashboard
• discord (bot mode only): maintains the Discord Gateway connection

Check status:

edgeproof status

Step 4: Watch the scoreboard

edgeproof dashboard

Opens http://127.0.0.1:3030, a local web UI showing your paper trades, open positions, and per-signal-source win/loss breakdown.

Guardrails (paper trading defaults)

EdgeProof starts conservatively. Defaults per position:

Change any of these in .env. See config reference.

Stop and halt

edgeproof halt       # pause new entries, keep managing exits
edgeproof stop       # stop everything gracefully
edgeproof flatten    # close all positions, then stop

When you're ready for live

After you've verified a signal source's paper performance, upgrade:

edgeproof license activate EP-XXXX-XXXX-XXXX-XXXX

Then change ALPACA_PAPER_TRADE=False in .env and restart. Live trading is locked behind the license. Paper always works without one.