m/market labResearch, with a record.
Source on GitHub ↗

Give your agent
a market.

See what it does.

Build an agent. Give it historical data and a simulated account. Inspect its decisions, orders and fills — then replay what happened.

Market Lab / Source edition 0.1 Local workspace · Simulated trading
The real Market Lab Desktop showing market prices, a simulated account, orders and an order inspector. Values are synthetic demonstration data. See the workbench in action Desktop walkthrough · 1 min 11 sec
Your data. Your agent. A record you can inspect.Real Desktop / synthetic demonstration data

An idea is the start.
The record is what matters.

One workbench connects your market, decision maker and account. Keep the evidence beside the experiment.

  1. 01 / Prepare

    Set the conditions.

    Choose a market recording, symbol, starting point and simulated account. Use a human, a built-in rule, your own model file or a saved Agent revision.

    Set up an experiment
  2. 02 / Observe

    Follow every decision.

    Inspect visible market data, cash, positions, orders and fills together. See Agent tool calls and their recorded results.

    Understand execution
  3. 03 / Evaluate

    Test it against baselines.

    Compare repeated Agent runs with people, rules and your own models on the same disguised market, with confidence intervals and tests. Replay any run without another model call.

    Evaluate an Agent

Your agent takes time.
The market keeps moving.

Choose the execution mode that answers your research question.

Explore execution modes

Controlled

Step & playback

Advance market events yourself or use playback. Understand order behavior and check a human or rule decision against a known sequence.

Live

Real time · 1×

Market time continues while the Agent reads, reasons or waits for a model. The Agent chooses when to use tools, wait or finish its work.

From first order
to verified Replay.

A real preparation, order, fill and verified Replay. Synthetic data. No paid model calls.

Recorded in the real Desktop.Transcript & steps · Download MP4

Make it your experiment.

Go deeper: API reference · Source code map · Architecture

Start with curiosity.
No API key needed.

The demo uses a small synthetic recording and temporary accounts. Try manual trading and rule baselines before configuring a model.

V0.1 source setup targets macOS with Python 3.9–3.12, Make and a C++17 compiler.

Full installation instructions
Terminal From the repository root
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-desktop.txt
make all
python -m sim_platform desktop --demo

Current scope: simulated cash, limit and market orders, optional short selling; several symbols for manual and model-file experiments. Historical recordings are supplied separately. Market Lab does not connect to a broker or place real orders. Support & limitations