FlyBrain v4.1.0 Space root layout: README.md

README.md

@@ -1,10 +1,28 @@
 ---
 title: FlyBrain Lab
-emoji: 📉
-colorFrom: yellow
-colorTo: gray
+emoji: 🪰
+colorFrom: gray
+colorTo: green
 sdk: docker
-pinned: false
+app_port: 7860
+pinned: true
+license: apache-2.0
+short_description: Drosophila connectome research workstation
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# FlyBrain Lab — Hugging Face Space (CPU build)
+
+Production research build of [timfromhcs/FlyBrain](https://github.com/timfromhcs/FlyBrain) v4.1.x.
+
+- **Graph:** `REAL_SUBGRAPH` — bounded sampled subgraph of Janelia MaleCNS v1.0
+  (256 neurons by default; the full 125,506-neuron graph is not instantiated —
+  see the in-app Provenance tab).
+- **Backend:** CPU LIF reference (`cpu_reference`). This Space has no Vulkan
+  GPU; `/api/health` reports the real backend and never fakes GPU telemetry.
+- **Populations** (visual, auditory, …) are coordinate heuristics, labelled
+  `HEURISTIC` in the UI and `/api/provenance` — never EM annotations.
+- **Weights** are a `synapse_count`-derived simulation transform, not measured
+  conductances.
+
+Endpoints: `/api/health` · `/api/version` · `/api/doctor` · `/api/state` ·
+`/api/telemetry` · `/api/provenance` · `/api/connectome` · `/ws/telemetry`.