Update README.md

README.md

@@ -1,12 +1,70 @@
 ---
-title: PerceptionLabPortable
-emoji: 🐢
-colorFrom: gray
-colorTo: gray
-sdk: static
-pinned: false
 license: mit
-short_description: A modular 'lab' full of odd nodes you can wire together
+tags:
+- consciousness
+- perception
+- crystallography
+- cymatics
+- eeg
+- python
+- visual-programming
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Perception Lab: Legoset 'science'
+
+**A node-based visual programming environment for exploring the physics of perception etc, lots of fringe weak ass ideas, but wiring the nodes is fun** 
+
+## 📥 Download & Run (Windows)
+
+This is a **Portable Application**. You do not need to install python or libraries. It is self-contained. Not all things may be kosher tho. There are 
+workflows and nodes that may be a bit broke. 
+
+1.  **Download the Archive:**
+    * [📥 **Download PerceptionLab_Portable.zip**](PerceptionLab_Portable.zip) (approx 339 mb)
+    * 
+    * *Note: This includes a full embedded python.. But once again, may lack some things. You may have to download
+    * eeg's etc. The Crystal chip that some workflows use. You may need to do that with the crystal chip maker tool from edf eeg. 
+
+2.  **Install:**
+    * Extract the ZIP file to a folder (e.g., `C:\PerceptionLab`).
+    * **Important:** Do not run it from inside the zip file. Extract it first.
+
+3.  **Run:**
+    * Double-click **`Start_Lab.bat`**.
+    * Wait 10-20 seconds for the Neural Engine (PyTorch) to initialize.
+
+---
+
+## 🌌 What is Perception Lab?
+
+It is some random nodes. Random ideas. Me thinking about thinking. The fun is in wiring the nodes. The 
+non fun is when things are broke. When things do not work. The nodes are very esoteric, some may work together, 
+some may not. You will see lots of neural fields. Mandalas, weird graphs. It may feel like racket science. So game on. 
+
+### Key Features:
+* **Holographic Fields:** Visualize standing wave patterns and Moiré interference in real-time.
+* **Biological Interface:** Native support for EEG data (EDF files) and BrainFlow integration.
+* **Cymatics Engine:** Simulate vibration modes and Chladni figures.
+* **Node-Based Workflow:** Over 300+ nodes including:
+    * *Quantum Qubits (Bloch Spheres)*
+    * *Fractal Attractors*
+    * *Neural Network Decoders*
+    * *Time-Crystals*
+    * *FFT/Spectral Analysis*
+
+## 📂 Repository Structure
+
+* **`PerceptionLab_Portable.zip`**: The main download. Contains the executable engine.
+* **`perceptionlab12.py`**: The core host source code (for developers).
+* **`nodes/`**: The library of logic nodes.
+
+## 🛠 Requirements
+* **OS:** Windows 10/11 (64-bit)
+* **GPU:** NVIDIA GPU recommended
+* **RAM:** 8GB minimum.
+
+---
+*Created by Antti's wild ideas and a bunch of different ai's* Inspired by ton of science papers. Thanks gais. 
+
+Feel free to rip it into pieces and remember. It is all for fun and games. But if you do manage to figure out 
+how consciousness works. Salud! Good luck space man.