Getting Started

Gordon is a crypto futures trading platform built on a v7 split topology: five Rust services, six kellnr-published library crates, a Next.js console, a Python research lab, and a one-shot schema migrator — all sharing a single PostgreSQL instance and a NATS JetStream bus.

The system runs a multi-strategy trend-following portfolio. Entry signals from validated strategies (Supertrend 3.0, EWMAC, PSAR) pass through overlay vetoes and portfolio-level circuit breakers before any intent reaches the exchange.

Who this is for

This is an internal LAN-only system. Documentation is written for the operator and sole developer.

Path from zero to running

1. Prerequisites — Docker, Rust 1.94.1, Node 20+, Python 3.12+, uv, sccache, cargo-nextest
2. Installation — make dev-init → make dev-up → make dev-seed
3. First Backtest — run a backtest via the manager BFF and inspect results in gordon-console
4. Project Structure — the v7 split: sibling repos, cross-cutting files, meta-workspace

Where to go next

Once the dev stack is running:

• Modules — per-service and per-crate reference
• Concepts — architecture deep dives, NATS topology, risk management
• Strategies — how each strategy is implemented and validated
• Operations — deploy, monitoring, runbooks
• Plan — active epics and what is in flight