Apppublic

trace-commons/web

sourceHugging Faceupdated 3mo agoView on Hugging Face

0likes

App README

Trace Commons — website + ingestion server

This Space serves two things from one origin:

—`GET /` — the Trace Commons website (index.html).
—`POST /donate` — the anonymous ingestion endpoint used by the `donate-trace` skill.

A donation is a single, already-locally-scrubbed coding-agent session. The server re-runs the exact same deterministic scrubber (scrub.py, kept byte-identical to the skill's) as a backstop, refuses anything that still trips a high-confidence secret pattern, and opens a pull request (never a direct push) to the dataset under a project-owned token. Contributors need no Hugging Face account.

Endpoints

Method	Path	Purpose
GET	`/`	The website
GET	`/health`	`{configured, dataset}` — `configured` is true once secrets are set
POST	`/donate`	Accept a scrubbed trace, backstop-scrub, open a PR

Configuration (Space secrets)

Secret	Required	Meaning
`HF_TOKEN`	yes	Write token for the project bot account
`DATASET_REPO`	yes	e.g. `trace-commons/agent-traces`
`MAX_BYTES`	no	Max payload size (default 5,000,000)
`RATE_PER_HOUR`	no	Donations per IP per hour (default 20)

If HF_TOKEN/DATASET_REPO are unset, /donate validates and scrubs the payload but returns 503 validated_not_published instead of opening a PR.

Dataset

Donations land in `trace-commons/agent-traces` under sessions/<harness>/<filename>, licensed CC-BY-4.0.