Update README.md

README.md

@@ -10,99 +10,58 @@ pinned: false
 license: other
 short_description: Live coherence + throughput benchmark (no precomputed result
 thumbnail: >-
-  https://cdn-uploads.huggingface.co/production/uploads/685edcb04796127b024b4805/Sr9bUuYsRuDtVZnb-7kke.png
+  https://cdn-uploads.huggingface.co/production/uploads/685edcb04796127b024b4805/Sr9bUuYsRuDtVZnb-
 
----
-
-# Coherent Compute Engine
+  <!-- README.md -->
+# Coherent_Compute_Engine
 
-This Space demonstrates a **live, coherent compute engine** running entirely on CPU.
+A real-time, on-machine benchmark that measures coherent state-update throughput and produces a tamper-evident receipt for every run.
 
-No precomputed benchmarks.  
-No synthetic scaling.  
-No hidden accelerators.
+## What it does
+- Runs a coherent update kernel over **N oscillators** for **S steps**
+- Measures:
+  - **Throughput** (B/s = billions of items per second)
+  - **Coherence** (|C| stability proxy)
+  - **Mean Energy** (bounded mean of E)
+  - **Elapsed time**
+- Produces a **downloadable receipt** (JSON) containing inputs, environment, outputs, and a **SHA-256** hash.
 
-Every result shown is produced **at runtime** on the machine hosting this Space.
-
----
+## What an “item” is
+**1 item = one per-oscillator coherent state update of `[Psi, E, L]` per step**, as implemented in this Space.
 
-## What Is Being Measured
+This definition is explicit so the metric is reproducible.
 
-Each “item” is defined as:
+## Verification / receipts
+Each run writes a receipt JSON under `results/` and exposes it via the UI.
+The receipt includes:
+- timestamp (UTC)
+- app version
+- platform + python
+- logical CPU count
+- inputs (N, steps, seed, scale)
+- measured outputs
+- SHA-256 hash of the canonical receipt JSON
 
-> One coherent update of a state vector `[Ψ, E, L]` for a single oscillator.
+This makes runs easy to share and tamper-evident.
 
-The engine evolves millions of oscillators using:
-- Numerically stable
-- Branchless
-- Energy-retentive updates
-
-Metrics reported:
-- **Throughput** — coherent updates per second
-- **Coherence** — stability between initial and final state
-- **Mean Energy** — energy retention across the system
-- **Elapsed Time** — real wall-clock time
-
----
-
-## Why This Matters
-
-Most benchmarks optimize for raw FLOPs.  
-This engine optimizes for **coherent progression under constraint**.
-
-It shows that:
-- High throughput does not require GPUs
-- Stability can be preserved at scale
-- Energy retention can remain high even under load
-
-This is **architecture**, not a paper claim.
-
----
+## Baselines (optional)
+If enabled, the Space also measures:
+- live **NumPy** baseline (vectorised)
+- tiny **Python loop** baseline (hard safety caps)
 
-## What This Is Not
+If `numba` is available, the primary engine automatically uses a Numba JIT kernel.
 
-- Not a neural network
-- Not a pre-trained model
-- Not a simulation with fixed outputs
-- Not a GPU demo
+## Important note about “your CPU”
+Hugging Face Spaces run on hosted hardware. The results reflect the **Space runtime**, not the visitor’s laptop CPU.
 
-It is a **compute engine**, measured live.
+If you want your own machine’s numbers, run the repo locally.
 
----
-
-## Reproducibility
-
-You can:
-- Change oscillator count
-- Change step count
-- Rerun at any time
-
-Results will change depending on:
-- Host CPU
-- Available cores
-- Runtime conditions
-
-That is the point.
-
----
-
-## Ethics & Transparency
-
-No data is uploaded.  
-No background processes.  
-No hidden scaling.
-
-What you see is what runs.
-
----
+## Files
+- `app.py` — Gradio app + benchmark + receipt writer
+- `results/` — receipts + `runs.csv` (created automatically)
 
-## Author
+## Licence
+Please read LICENCE, listed in repo
 
-Built as part of the **Rendered Frame Theory (RFT)** engineering work.
 
-Focus:
-- Truthful measurement
-- Energy-aware compute
-- Coherent system design
-  
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+  Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference