origami-trace 0.1.1

Local-first experiment history CLI.

Origami Trace

origami-trace ships the public otrace ingestion CLI for recording experiment runs in a hosted Trace project.

Use it when a training, evaluation, or data-processing run should upload its command, setup, logs, metrics, tables, and artifacts so the results are inspectable later.

Install

pip install origami-trace

Authenticate

Create a Trace project API key in the Trace dashboard, then initialize a workspace:

export TRACE_API_KEY="trc_your_key_here"
otrace init
otrace whoami

Run An Experiment

otrace run \
  --intent "Evaluate baseline on validation split" \
  --setup "Baseline config with validation data" \
  --expect-artifact outputs/metrics.json \
  --expect-log outputs/eval.log \
  -- python eval.py --config configs/baseline.yaml

If the project does not already write queryable outputs, create starter output files:

otrace scaffold outputs

Public Commands

otrace init
otrace login
otrace whoami
otrace scaffold outputs
otrace run
otrace import

The published package is intentionally limited to ingestion and hosted upload.