Every serious trader ends up juggling ten tabs, three terminals, a TradingView chart, a half-broken Polymarket script, and a Slack channel full of signals nobody has time to read.

OpenTradex is the command cockpit that replaces the tab sprawl. A single dashboard that speaks to prediction markets, equities, crypto, and forex through one AI-driven harness — local-first, paper-by-default, and fully yours.

 scan markets -> AI filters signal -> you approve trade -> paper fill -> review

No SaaS. No account. No telemetry. Your API keys stay on your machine.

npx opentradex onboard --paper-only && npx opentradex run

Grab the signed installer from Releases — Windows builds are Authenticode-signed, macOS builds are Developer ID-signed and notarized, so no SmartScreen or Gatekeeper warnings on install.

Prefer to build it yourself (unsigned dev build)?

git clone https://github.com/deonmenezes/opentradex.git
cd opentradex
npm install
npm run build:all
npm run build:desktop:win   # or :mac / :linux

Installer lands in packages/desktop/release/. Code-signing is automatically skipped when the env vars below are absent, so local dev builds always work.

The .github/workflows/release.yml pipeline picks these up on tag push (git tag v1.0.0 && git push --tags):

Store these as GitHub Actions secrets. They are never logged and never bundled into the installer.

# iOS (SwiftUI, native)
open packages/ios/OpenTradex/OpenTradex.xcodeproj

# Android / iOS (Expo)
cd packages/mobile && npm install && npx expo start

# 1. First-time setup — pick your rails, set paper mode, drop in API keys
opentradex onboard

# 2. Boot the gateway (HTTP + WS on :3210)
opentradex run

# 3. Open the cockpit
npm run ui                  # web
npm run desktop             # Electron

Then tell it what to do:

> scan all markets and propose the best trade under $50 risk
> close BTC-EOY-120K on kalshi
> analyze "Fed cut September" news from reuters
> panic

┌────────────────────────────────────────────────────────────────────────────────┐
│  OPENTRADEX  Live  PAPER          PORTFOLIO $15,238   DAY +$184.27   [Run]▶   │
├────────────────┬──────────────────────────────────────────┬───────────────────┤
│ POSITIONS   2  │       What should we trade next?         │  Live feed   12  │
│ BTC-EOY-120K   │                                          │  Reuters    14m   │
│ FED-SEP-CUT    │   ⚡ Connector Audit                      │  Bloomberg  28m   │
│                │   ⚡ Cross-Market Scan                    │  FT         45m   │
│ MARKET SCANNER │   ⚡ TradingView Pass                     │  CNBC       33m   │
│ FED-SEP 43¢    │                                          │  WSJ        48m   │
│ BTC-EOY 38¢    │   COMMAND · _                            │  CoinDesk   62m   │
└────────────────┴──────────────────────────────────────────┴───────────────────┘

• Left rail — open positions, recent fills, live market scanner
• Center — chat interface to the AI harness with quick-start missions
• Right rail — unified news + social feed with $TICKER tagging
• Top bar — capital, day P&L, run cycle, auto-loop cron (1/2/5/10/15/30 min)
• Markets page — the Houston-style Connectors grid with logos, status pills, and one-click Connect

Want to wire a new one? Drop a file into src/markets/<name>.ts that exports scan, quote, and send — the harness auto-discovers it.

The harness speaks to whichever model you already have:

Configure in ~/.opentradex/config.json:

{
  "ai": {
    "provider": "anthropic",
    "model":    "claude-opus-4-7",
    "apiKey":   "sk-ant-..."
  }
}

opentradex/
├── src/                        # The harness — the thing that actually trades
│   ├── agent/                  # scanner, executor, risk, runner, logger
│   ├── ai/                     # provider registry + adapters
│   ├── markets/                # per-exchange connectors
│   ├── gateway/                # HTTP + WebSocket + SSE server (:3210)
│   ├── mcp/                    # MCP bridge for TradingView etc.
│   ├── risk.ts                 # Kelly sizing, daily-loss caps, kill switches
│   ├── config.ts               # Config + mode lock
│   ├── onboard.ts              # Interactive setup wizard
│   └── bin/cli.ts              # `opentradex` CLI entry
│
├── packages/
│   ├── dashboard/              # React + Vite + Tailwind cockpit
│   │   └── src/components/     #   TopBar · LeftSidebar · ChatCockpit · RightSidebar
│   │       ConnectorLogo.tsx   #   Branded SVG marks for all 12 rails
│   │
│   ├── desktop/                # Electron shell (Windows / macOS / Linux)
│   │   ├── src/main.ts         #   Boots gateway + loads dashboard
│   │   └── electron-builder    #   NSIS · APPX · DMG · MAS · AppImage · deb · snap
│   │
│   ├── ios/                    # Native SwiftUI client
│   └── mobile/                 # Expo React Native (iOS + Android)
│
└── docs/                       # Screenshots, design notes

The gateway is the only thing the dashboard, desktop, and mobile clients talk to. It's a plain HTTP server — you can curl it, hit it from another app, or wire it into n8n.

Event types on the wire: position · trade · feed · market · command · panic · heartbeat

const ws = new WebSocket('ws://localhost:3210/ws');
ws.onmessage = (e) => {
  const { type, payload } = JSON.parse(e.data);
  // type: 'position' | 'trade' | 'feed' | 'market' | ...
};

The mode is persisted in ~/.opentradex/config.json and enforced by src/config.ts on every outbound order. There is no runtime override.

Want to run the harness on a VM and drive it from your laptop / phone?

opentradex onboard         # pick "lan" or "tunnel" bind mode

That generates a bearer token — printed once, never stored elsewhere. Pass it on every call:

curl -H "Authorization: Bearer $OPENTRADEX_TOKEN" http://vm.lan:3210/api/

The mobile apps prompt for host + token on first launch.

The cockpit is calibrated for 8-hour sessions in a dark room:

npm install                  # root workspaces install everything

npm run build                # compile src/  -> dist/
npm run build:dashboard      # Vite build
npm run dev:dashboard        # HMR dashboard on :5173
npm run desktop              # Electron dev with live gateway
npm run ui                   # Web-only (no Electron)

packages/desktop talks to :3210 whether it spawns the gateway itself or finds one already running. packages/dashboard is served by the gateway at / in production — single source of truth, no double port.

This repo is the public, ready-to-fork mirror. Clone it, wire your own keys, and you're live on paper in under a minute:

git clone https://github.com/deonmenezes/opentradex.git
cd opentradex
npm install && npm run build:all
npx opentradex onboard --paper-only
npx opentradex run

MIT. Trade responsibly. No warranty — this is paper-first for a reason.