Repository navigation
Releases
Market Lab 1.0.0
First stable release: the public API is frozen (API stability),
installers and wheels are built for macOS, Windows and Linux, and CI runs on all three.
-
Agents on several symbols read the experiment's news with
news.list, point in time. -
Live human, rule, hold and model-file runs fail on lag only when execution stays over
100 ms behind live time for 1 s; a single stall no longer ends the run. -
Borrow on a short still open at the end of a run is accrued in the run's costs
(pnl_attribution()['costs']['borrow_accrued']); the cash ledger still charges borrow
at cover. -
Versioned API reference generated from docstrings with Sphinx (
tools/build_api_reference.py),
built into the website underapi/<version>/bytools/build_pages.py. -
Four example notebooks (
examples/notebooks/): Agent vs rule vs neural network,
evaluation and review, execution models, sweep and heat map; CI runs them. -
Troubleshooting, governance,
CODEOWNERSandCITATION.cff; pull requests are now welcome. -
Release pipeline: on a version tag the release workflow checks tag, version and
changelog, publishes to PyPI by trusted publishing and creates a GitHub Release with
installers, checksums and provenance attestations, each behind maintainer approval. -
Agent sandbox: the experiment setting
sandbox(kindauto, macos, bubblewrap or
podman;networknone, local or model) runs an imported Agent's process under
sandbox-exec, bubblewrap or a rootless Podman container with writes confined to its
work folder. Agent SDK 0.1.5. -
CI: Windows (MSVC native build, platform and Desktop tests, wheel demo) and Linux
sandbox jobs; pip-audit, CodeQL and a CycloneDX SBOM (security.yml). -
Public API: API stability defines the public API,
semver and deprecation;tools/check_public_api.pyfreezes it in
tests/fixtures/public-api.jsonand CI fails on an unrecorded change. -
Local models: the
openai-compatibleprovider talks to a Chat Completions server on
this machine or a private network (vLLM, Ollama, llama.cpp, LM Studio) at
ModelProfile.base_url, with no key needed; public hosts are refused so data stays on
premises. The Desktop's Agent editor offers it as Local server. -
Model budgets: the Agent setting
budget(max_tokens, and/ormax_usdwith
prices) ends a run cleanly, statusstoppedand reasonbudget, before a model
request once the budget is spent; evaluations reportbudget_exceeded. -
Experiment lineage: every run records, write once, its code version and commit, rule
and native-library digests, configuration digest and the SHA-256 of every input file;
its records are sealed when it ends and an Agent's log, model and served versions when
the log is archived.Platform.run_lineage()reads it andPlatform.verify_run()
proves a stored run unchanged or lists what changed. -
Platform.decision_timeline()links each Agent order to the reads, model replies and
journal notes of its round;Platform.pnl_attribution()reports alpha, beta to the
traded market, optional factor exposures and commission/borrow/impact costs. -
Platform.model_risk_report()exports one run's or a study's assumptions, data
digests, model, tests and limits as JSON or Markdown;Platform.diff_runs()lists the
settings, prompt, model, data, code and results that differ between two runs. -
Platform.run_sweep()runs a grid of parameters or Agent prompts (each prompt saved
as a revision) on every recording, with a results table, deflated Sharpe ratios that
count every combination as a trial, andresearch.sweepsheat maps (SVG). -
Headless parity:
market-labcommandsagents,agent-import,credential,
experiment --config,evaluate-runs,suite,sweep,disguise,split,
lineage,verify,timeline,attribution,diffandrisk-reportcover every
Desktop research workflow (research.headlessruns one experiment from JSON). -
Offline mode (
MARKET_LAB_OFFLINE=1) refuses the hosted provider and every download;
an acceptance test runs a whole study while auditing socket connections. -
research.forward.ForwardTestforward-tests a method in shadow mode on arriving bars:
one run per batch on one account, with an append-only arrival log. -
research.portfolio: equal, inverse-volatility, risk-parity and minimum-variance
weights, volatility targeting, exposure limits, share targets and rebalance orders. -
The Desktop's saved Agent result lists each order with the reads, model replies and
notes of its round (Agent decisions). -
Wheels include the native library (
setup.py,tools/native_build.py), tagged
py3-none-<platform>;pip install .compiles it when a C++17 compiler is present.
tools/build_desktop.pybuilds a macOS.dmg(signed and notarised when the
maintainer's identity is set), a Windows Inno Setup installer and a Linux AppImage;
.github/workflows/release.ymlbuilds wheels (cibuildwheel), the sdist and the three
installers as workflow artifacts. The frozen App now ships the execution-rule sources
that Replay identifies, so preparing a market works in the bundle. -
The package installs with
pip install .and provides amarket-labcommand; the
native library is found throughMARKET_LAB_NATIVE_LIBRARY, the package orbuild/. -
Diagnostics use Python logging:
--log-leveland--log-jsonon the command line,
MARKET_LAB_LOG_LEVEL/MARKET_LAB_LOG_FORMAT, ordiagnostics.configure_logging().
Handled failures are logged with their traceback; nothing prints by default. -
Platformmethods are grouped into records, Agent and credential modules; the public
API is unchanged. -
Execution models:
displayed-limit-queue-v1fills resting orders after the displayed
shares ahead of them trade;impact_bpsadds square-root market impact (fills record
quoted_price);latency_jitter_nsadds a per-order delay fixed by the order ID. -
Agent tools
documents.searchanddocuments.readover filings and reports
(documents_path);convert_news()andconvert_documents()import vendor exports at
their publication times;fundamentals_pathalso reads ALFRED macro vintages and
folders of files; theDataConnectorprotocol connects a vendor through the same
files.disguise_recording()disguises news and fundamentals with the prices.
research.universefinds survivorship bias in a symbol choice.research.frames
exports results as tables, pandas DataFrames, CSV or Parquet, and Parquet bars
convert to recordings (optional extrasparquetanddataframes). -
Execution settings
latency_sigma_milli(lognormal latency with a heavy right tail)
andborrow_bps_per_year(borrow cost charged when a short is covered, recorded as
borrow_fee). -
Evaluations count an Agent entry's saved revisions as its trials when none are given
(trial_sources), list the model versions the provider served (served_models) and
warn when an entry mixes them.Platform.split_recording()writes walk-forward
train/test windows, andResearchBatch.evaluate_benchmark()runs a reproducible
five-regime benchmark against fixed baselines. -
Evaluations report the probabilistic and deflated Sharpe ratio per entry (
trials
says how many configurations were tried) and the probability of backtest overfitting
across entries.research.overfittingadds walk-forward and purged k-fold splits. -
Agent tools
news.listandfundamentals.get. Fundamentals come from a CSV or an SEC
EDGAR companyfacts file (fundamentals_path) and are point in time: each figure and
each restatement is visible only from its publication date. An Agent may now be
granted, and offer its model, up to 32 tools (was 16). -
Several symbols for Agents (
symbolsin the Agent settings; every market tool takes any
of them), for Live manual trading and for the rule and hold methods (one rule per
symbol). Live and Agent runs schedule against a merged timeline, and Replay rebuilds
every symbol's market. -
Reference Agents:
paperandstrictexecution presets, model usage per role
(TradingAgentlabel,by_label), ajournal.writetool read with
Platform.agent_journal(), beliefs carried into a later run, andRehearsalProvider
to rehearse any Agent without model calls. Reference Agents accept Python 3.9 to 3.14.
The Desktop fills a chosen reference Agent's name. -
Reference Agents after TradingAgents, FinMem and FinCon, selectable in the Desktop's
New Agent form or withPlatform.import_reference_agent().TradingAgentaccepts
finish_toolsso a role can end its turn with a local tool. -
ModelProfile.temperatureis sent to the provider and recorded with each Agent run. -
Methodology states fill assumptions, statistics and
known biases. -
Contributor guide, issue and pull-request templates, Dependabot, a coverage job for
Python 3.9–3.12 and a wheel install check in CI.