Skip to content

README.md

Latest commit

 

History

History
56 lines (40 loc) · 3.48 KB

README.md

File metadata and controls

56 lines (40 loc) · 3.48 KB
Raw

QRAE QuantOS

QRAE QuantOS is a local-first kernel for reproducible quantitative-research experiments with explicit provenance and human authority gates.

Status & honesty

Active research harness. No headline performance result; the deliverable is the harness. The public fixture is synthetic, its work order caps evidence at E0, and no in-sample, out-of-sample, profitability, or alpha result is claimed. The quality branch records 228 passed tests and 4 platform-dependent skips; those checks establish software behavior, not investment performance.

Architecture

  • A hash-bound work order identifies the dataset, point-in-time cutoff, registered costs, split policy, and evidence ceiling.
  • DataCatalog freezes normalized inputs and manifest evidence as immutable SHA-256-addressed objects; every lookup requires an as_of time.
  • The local kernel runs a chronological lagged baseline, independently recomputes metrics, and appends hash-linked state and claim artifacts.
  • The optional Codex broker accepts a bounded read-only task, then HMAC-signs a result receipt outside the workspace; ingestion cannot change metrics, research state, capital, or execution authority.
flowchart LR
    A[Work order<br/>dataset hash + as-of] --> B[Point-in-time catalog<br/>immutable objects]
    B --> C[Deterministic kernel<br/>chronological split + costs]
    C --> D[Run manifest<br/>metrics + hash-linked state]
    D --> E[Offline verification]
    D -. bounded draft request .-> F[Read-only Codex broker]
    F --> G[HMAC receipt<br/>no state-transition authority]
    G --> E
Loading

The interesting decision

Provenance and temporal availability are executable gates rather than report annotations: a run is refused when its hashes, point-in-time contract, evidence ceiling, or authority boundary do not validate. This makes replay and review mechanically checkable; the tradeoff is additional manifests, immutable artifacts, and deliberate refusal to promote observed-at-import or public-metadata inputs beyond E0.

Provenance

The implementation in src/qrae/ and the synthetic fixture are maintained in this repository. The requirements use RD-Agent-style research/development feedback and score terminology, but the tree contains no vendored microsoft/RD-Agent source and does not depend on that package. The bounded metadata adapter targets Polymarket's public Gamma API and explicitly records its terms as unverified. No repository license was present at audit time, so reuse rights remain UNKNOWN and no license was inferred.

Run it

From a clean clone with Python 3.10 or newer:

python -m venv .venv
# PowerShell: .\.venv\Scripts\Activate.ps1
# POSIX: source .venv/bin/activate
python -m pip install -e ".[dev]"
python -m pytest -q
python -m ruff check .
python -m ruff format --check .
python -m pyright
python -m qrae.cli run --work-order examples/price_baseline/work_order.json --workspace . --output-root .quantos
python -m qrae.cli verify --run-dir .quantos/runs/<run-id>

The last two commands exercise only the committed synthetic fixture and write ignored artifacts under .quantos/.

Limitations

The repository contains no licensed historical dataset or validated alpha record. Manifest validation can prove internal consistency but not legal entitlement or external authenticity. Provider-specific automated historical adapters, walk-forward model selection, portfolio and risk engines, paper execution, and live execution remain incomplete; no LLM output can authorize any of them.