Get started / v0.4.1

Your first
recorded case.

Install Metriplane. Run the bundled example. Open an Incident Report on your own machine.

Python 3.12–3.13No camera or GPULocal-first
Check platform support
v0.4.1 · PyPIPython 3.12–3.13
python -m pip install "metriplane==0.4.1"metriplane demo --open
No camera or GPU needed.

Run in your terminal. The report opens in your browser.

Prefer conda? Run conda install conda-forge::metriplane. Open the conda-forge package.

Working without a browser? Run metriplane demo and open the generated report later.

Exact package and release record

v0.4.1 · 12 September 2026. PyPI package · conda-forge package · GitHub release. Release commit: 306279aae7ebddd403e06b83659b590eb981b25f.

The bundled path replays packaged object state against process rules, verifies its evidence bundle, and runs the generated incident check. It is separate from the 128-episode campaign.

Your first result

The command ends.
Your case stays open.

Six events become one missing-tool incident, an inspectable report and a check you can rerun. All generated on your machine.

  1. Read the result

    Open cell_truth_report.html to follow the events that produced the incident.

  2. Keep the evidence

    The ZIP preserves the case and its replay inputs. Local verification checks its integrity.

  3. Repeat the check

    The generated YAML detects the expected incident again. A pass does not mean the tool was repaired.

Archived output from the published 0.3.0 package, retained as a historical recorded demo. This missing-tool example is separate from campaign E0104 and its 0.50 s handoff lateness.

Bundled example / v0.3.0INC-0001

metriplane_demo_v1

A missing tool.
A measurable delay.

35.0 sRecorded process delay

The required torque_driver_1 was absent when fastening needed it.

Missing tool observed
20.0 s
35.0 s delay recorded
55.0 s
Tool present
70.0 s

Bundle verified. Regression passed.The expected missing-tool incident was detected again.

Read report (Markdown)

Made to run locally.

Once installed, the bundled demo is offline and deterministic.

Hardware
No camera or GPU required
Environment
No Docker, ROS or source checkout
Network
Not required after installation
Browser
Optional

On SSH or another headless system, run metriplane demo and open the generated report later.

v0.4.1 support

Support claims follow the tests that actually ran.

Ubuntu

Ubuntu: the governed full suite passed on Python 3.12 and 3.13, followed by clean wheel and source-distribution installation checks.

macOS

macOS: every deterministic shard passed on Python 3.12 and 3.13. Broader hardware functionality is not claimed.

Exact distribution

Inspect the files that production PyPI serves.

The published metadata requires Python >=3.12,<3.14. The wheel and source distribution were built once, strictly validated, and installed independently outside the source checkout.

python -m pip install "metriplane==0.4.1"

Version boundaries

Package delivery, SoftwareX evidence, and TIM measurements are separate records.

v0.4.1 product release

Published assurance-hardening release. Cite the exact GitHub software release; no v0.4.1 DOI is assigned.

Open exact release

v0.1.3 TIM boundary

The protocol preprint’s evaluated software and measurements remain tied to v0.1.3; later packages do not retroactively produce those results.

Open evaluated release