OptionLab

OptionLab is the open-source lab for market systems.

Build, test, and run user-defined market automation with a deterministic runtime, plugin interfaces, broker/data adapters, an audit journal, and replay tooling. Users define the logic. Users define the risk scale. OptionLab runs the machinery.

OptionLab does not tell users what to trade, when to trade, or how much to trade.

Quick Start

Prerequisites:

• Python 3.11+
• Node.js 20+
• GNU Make

git clone https://github.com/davidjbeveridge/OptionLab
cd OptionLab
make dev-up
make demo
make run

The demo writes a local audit journal to .optionlab/journal.jsonl and replays it without any hosted service.

Local Credentials

OptionLab keeps credentials local. For experiments, use environment variables or a local ignored file:

export OPTIONLAB_BROKER=sim
export OPTIONLAB_MODE=paper
make run

Live adapters are interfaces for user-controlled local execution. You are responsible for broker credentials, risk scale, legal compliance, and every activation decision.

What Is Included

• Strategy and StrategyVersion primitives
• StrategyExecution configuration and activation records
• Deterministic decision engine
• Plugin/provider manifest interfaces
• SimBroker and local market data stubs
• OMS/order-plan compiler
• Risk/exposure checks
• JSONL audit journal
• Replay harness
• Local Studio UI
• Static Cloudflare-ready website under site/

What Is Not Included

• Hosted SaaS operations
• Billing or paid-plan rails
• Creator payouts
• Hosted OAuth app credentials
• Production vault/KMS infrastructure
• Enterprise SSO/RBAC
• Managed workers or managed backtest compute
• Hosted alert delivery

Commands

make dev-up       # create local runtime env
make demo         # run deterministic local demo and replay it
make run          # run the local paper path
make studio       # start local Studio at http://localhost:3000
make site-build   # validate the static website
make gate-ci      # runtime tests, Studio build, site build, public-safety scan

Plugin Model

Plugins describe capabilities. Provider instances bind local configuration and credentials. The runtime records the plugin fingerprint in the journal so decisions can be audited and replayed.

Risk Boundary

OptionLab provides software tooling, research infrastructure, deterministic automation, and plugin-based execution interfaces. It is not an investment adviser, broker-dealer, signal service, copy-trading platform, or managed account service.

Website

The static website lives in site/ and is ready for Cloudflare Pages. Production target: optionlab.org.