Update Space README: nvidia/ ownership + cpu-upgrade guidance

README.md

@@ -7,4 +7,34 @@ sdk: docker
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# SimReady Validator
+
+Validates a HuggingFace dataset against a [SimReady](https://github.com/NVIDIA/simready-foundation) profile.
+
+Reads the dataset directly from HF storage (no copy onto external
+infrastructure), runs the bundled
+[`simready-report`](./tools/validation/plugins/simready-report/) validator
+with `--no-use-kit`, and — when the **Open PR** checkbox is enabled —
+uploads the verdict to the dataset as a `validation/` pull request.
+
+## Source
+
+This Space is generated from the
+[`NVIDIA-dev/simready-oem-library-pm`](https://github.com/NVIDIA-dev/simready-oem-library-pm)
+internal repo (see `tools/hf_space/`). Bug reports and feature requests go
+there; this Space is the deployable artifact, not the source of truth.
+
+## Hardware
+
+`cpu-basic` is enough for a smoke test (no Kit re-exec on this Space).
+For routine validation of partner datasets at scale, upgrade to
+`cpu-upgrade` (8 vCPU, 32 GB) — the validator's `ProcessPoolExecutor`
+actually scales there. Kit-rooted PhysX/MDL rule coverage needs a GPU
+tier (`a10g-small`) and Isaac Sim baked into the image, neither of
+which is in the current image.
+
+## Secrets
+
+| Name | Purpose |
+|---|---|
+| `HF_TOKEN` | Write-scoped Hugging Face token used to open verdict PRs on customer datasets. Set under Settings → Variables and secrets. |