QuantElse Local Runtime 0.1.7
Platform: macOS Apple Silicon

This is an unsigned, paper-first preview build of the complete quantelse-local
strategy workspace. It includes Python, CCXT, and the local UI. You do not need
to install Python, Node.js, Docker, or CCXT.

QUICK START

1. Keep this whole directory together. Do not move only the executable.
2. Validate the bundled paper configuration:

   ./quantelse-local/quantelse-local validate --config composition-v5.example.json

3. Start the runtime and loopback UI:

   ./quantelse-local/quantelse-local run --config composition-v5.example.json \
     --state-dir ./state --ui

   Or double-click start-local-ui.command on macOS after explicitly allowing
   this unsigned preview in System Settings if Gatekeeper blocks it.

4. Open http://127.0.0.1:8765/ if the browser does not open automatically.

OPTIONS PAPER QUICK START

The same runtime also contains the independent options-income framework with
BTC/ETH Wheel and near-expiry short-volatility parameter packages. Validate and
run the deterministic synthetic snapshot first:

   ./quantelse-local/quantelse-local options-validate \
     --config options-income.example.json

   ./quantelse-local/quantelse-local options-run \
     --config options-income.example.json --state-dir ./state --once \
     --snapshot options-income.synthetic-snapshot.json

Open the dedicated loopback workbench (its page also contains the complete CLI
quick start):

   ./quantelse-local/quantelse-local options-run \
     --config options-income.example.json --state-dir ./state --ui \
     --snapshot options-income.synthetic-snapshot.json \
     --host 127.0.0.1 --port 8766

Then open http://127.0.0.1:8766/. The synthetic snapshot is run once at
startup; the workbench remains available for inspection without replaying stale
market data on a schedule.

Omit --snapshot only when you intentionally want credential-free public
Binance Options market data. This framework remains Paper-only. Binance Options
are cash-settled, so its Wheel is not a physical-assignment Wheel.

The default technical example uses deterministic built-in Paper candles and
writes only paper orders to local SQLite, so it runs without network access.
In the workbench you may switch the signal source to credential-free Binance
USD-M, OKX USDT Swap, or Hyperliquid public candles. Downloaded candles are
cached under the local state directory. Exchange network routing supports the
system route, forced HTTP direct mode, or an unauthenticated HTTP(S) proxy.
--offline disables QuantElse bootstrap, Catalog refresh, and telemetry; it does not prevent a
public exchange source that you explicitly select from requesting market data.

LINEAR-PERPETUAL LIVE OPT-IN

Live is disabled unless the Runtime starts with --enable-live. On macOS you may
double-click start-local-ui-live.command; on other systems use the matching live
launcher or append --enable-live to the command above. In the loopback UI:

1. Save and validate a trade-only, no-withdrawal account in the OS keyring.
2. Create a Config v5 parent strategy in Live mode. Legacy single-bot live is
   intentionally rejected.
3. Review the contract, settlement asset, leverage, margin mode, and symbols.
4. Enter I_UNDERSTAND_THIS_CAN_PLACE_REAL_ORDERS to activate it. Activation
   reads account equity/positions and verifies every target contract; it sends
   no order by itself.

Live cycles use market orders against the actual position delta. Reversals close
reduce-only first and open the other side on a later cycle. Unknown or open order
states pause the strategy. Use the order probe/reconciliation controls before
reactivating. The kill switch stops new orders but does not flatten positions.

SECURITY BOUNDARY

- Paper is the default; live always requires an explicit Runtime switch, a
  validated keyring account, a Live composition draft, and second confirmation.
- Strategy JSON never contains API keys or private keys.
- Local secret commands and loopback settings use the operating-system keyring.
- Exchange timeouts are treated as unknown order state and are never retried
  automatically before reconciliation.
- The local UI binds to loopback and closing the page does not stop the runtime.
- Verify the ZIP SHA-256 shown on the QuantElse download page.

中文提示：这是未签名的本地预览版。默认仍为 Paper；只有用实盘启动器启动、
在本机密钥库保存已验证账户、创建 Composition v5 实盘草稿并二次确认后，
才可能发送真实市价单。请先用 Sandbox 和极小仓位自行验证。
