Metadata-Version: 2.4
Name: origami-trace
Version: 0.1.1
Summary: Local-first experiment history CLI.
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# 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

```bash
pip install origami-trace
```

## Authenticate

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

```bash
export TRACE_API_KEY="trc_your_key_here"
otrace init
otrace whoami
```

## Run An Experiment

```bash
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:

```bash
otrace scaffold outputs
```

## Public Commands

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

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