Add model card

README.md

@@ -0,0 +1,59 @@
+---
+language: en
+library_name: custom
+license: mit
+tags:
+  - connectome
+  - fruit-fly
+  - neuroscience
+  - spiking-neurons
+  - generative-signal
+  - c-elegans
+  - procedural
+  - audio
+  - game-dev
+  - reservoir-computing
+  - non-learning
+  - real-brain-data
+pipeline_tag: other
+---
+
+# Fly-Instinct - Real Connectome "Instinct" Signal Engine
+
+A frozen, non-learning recursive network built on the **real fruit-fly MaleCNS connectome** (Janelia 2024). Feed any stimulus, get an organic, structured "instinctive" signal that is more alive than noise, less predictable than a script.
+
+**Not AI. Not a brain. Not learning. Just real neural wiring, frozen.**
+
+## What you get
+
+- Real MaleCNS connectome subset (1,587,930 edges, ~25 MB)
+- 4 tuned presets: escape / sugar / startle / explore
+- Bonus: C. elegans (309-neuron) connectome + 4 presets
+- Zero training. Weight-frozen. Deterministic per seed.
+
+## Quick start
+
+```bash
+pip install fly-instinct
+fly-instinct fetch-data
+fly-instinct run --preset escape --duration 5 --out signal.wav
+```
+
+## Browser demo (no install)
+
+https://roblitz-spec.github.io/fly-instinct/
+
+## Links
+
+- GitHub: https://github.com/roblitz-spec/fly-instinct
+- PyPI: https://pypi.org/project/fly-instinct/
+- Full 1.05GB connectome + commercial license: https://robloxer31.gumroad.com/l/Fly-Instinct
+
+## Data provenance
+
+- Fruit-fly: Janelia MaleCNS (CC-BY 4.0), https://male-cns.janelia.org
+- Roundworm: White et al. 1986 + Wang et al. 2024 neurotransmitter polarity
+
+## License
+
+Code: MIT | Data: CC-BY 4.0 (attribution required)