data/traces/README.md

# Traces

Reserved for anonymized public traces.

Target: at least 6 public traces for the Sharing is Caring badge.

## Current Samples

`samples/` contains six stable mock traces generated from the example objects:

```bash
.venv/bin/python -B scripts/generate_sample_traces.py
```

These traces use the current mock runtime and are safe placeholders until real VLM and llama.cpp traces are available.

`../space-vlm/` contains hosted Space validation evidence from the June 8, 2026 ZeroGPU run. Those traces are intentionally kept separate because they include `vision-fallback-to-mock` and should not replace the six stable demo samples.

Export the validated sample traces as JSONL:

```bash
.venv/bin/python -B scripts/export_traces.py
```

Default output:

```text
data/traces/samples/objectverse_public_mock_traces.jsonl
```