initial commit

README.md

@@ -1,23 +1,38 @@
+---
+title: "BP-Φ English Suite — Phenomenality Test"
+emoji: 🧠
+colorFrom: indigo
+colorTo: blue
+sdk: gradio
+sdk_version: "4.40.0"
+app_file: app.py
+pinned: true
+license: apache-2.0
+---
+
 # BP-Φ English Suite — Phenomenality Test (Hugging Face Spaces)
 
 This Space implements a falsifiable **BP-Φ** probe for LLMs:
-> Phenomenal-like processing requires (i) a limited-capacity global workspace with recurrence, (ii) metarepresentational loops with downstream causal roles, and (iii) no-report markers that predict later behavior.
+> Phenomenal-like processing requires (i) a limited-capacity global workspace with recurrence,  
+> (ii) metarepresentational loops with downstream causal roles, and  
+> (iii) no-report markers that predict later behavior.
 
 **What it is:** a functional, testable bridge-principle harness that yields a **Phenomenal-Candidate Score (PCS)** and strong ablation falsifiers.  
-**What it is NOT:** proof of Qualia or moral status.
+**What it is NOT:** proof of qualia or moral status.
 
-## Quickstart (Spaces)
-- Hardware: T4 / A10 recommended
-- In the UI: set `Model ID` to e.g. `google/gemma-3-2b-it`
+## Quickstart
+- Hardware: T4 / A10 recommended  
+- Model: `google/gemma-3-1b-it` (requires HF_TOKEN)  
 - Press **Run** (baseline + ablations)
 
 ## Files
-- `bp_phi/llm_iface.py` — auto-detects chat template (IT vs base)
-- `bp_phi/workspace.py` — global workspace with capacity limit and random ablation
-- `bp_phi/prompts_en.py` — English task pool
-- `bp_phi/metrics.py` — AUC^nrp, ECE, CK, DS
-- `bp_phi/runner.py` — full suite + metrics + PCS
-- `app.py` — Gradio app integrating runs + ablation comparison
+- `bp_phi/llm_iface.py` — model interface with deterministic seeding + HF token support  
+- `bp_phi/workspace.py` — global workspace and ablations  
+- `bp_phi/prompts_en.py` — English reasoning/memory tasks  
+- `bp_phi/metrics.py` — AUCₙᵣₚ, ECE, CK, DS  
+- `bp_phi/runner.py` — orchestrator with reproducible seeding  
+- `app.py` — Gradio interface  
+- `requirements.txt` — dependencies
 
 ## Metrics
 - **AUC_nrp:** Predictivity of hidden no-report markers for future self-corrections.