Update README.md

README.md

@@ -9,11 +9,30 @@ license: openrail
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
-# 🧠 CodexWebVM
+# CodexWebVM — Self-Hosting Interactive Cognitive Engine
 
-A self-hosting cognitive system embedded with animated SVG/MP4 cognition engine and responsive runtime hosted via FastAPI on Hugging Face.
+This Space hosts a fully interactive **SVG cognitive engine** driven by mathematical dynamics:
 
-- 🌐 Virtualized self-hosting HTML runtime
-- 🧠 Cognitive animation loop
-- ⚙️ JS runtime hooks
-- 🚀 Deployable on Hugging Face Spaces
+**Equation:** dΞ/dt = −Λ ∇Ξ (Θ + Φ − Ψ + Ω)
+
+## How to Use
+
+Type commands into the Ψ(t) input and press **Enter** to see the virtual machine state evolve.
+
+## Deployment
+
+This repository can be deployed as:
+
+- **Static HTML on HF Static Space**
+- **Dynamic FastAPI on HF Docker Space**
+- **Container on any Docker host**
+
+## Files
+
+- `index.html`: Main interactive interface
+- `engine.js`: Logic runtime
+- `style.css`: Visual styling
+- `backend.py`: Optional server
+- `Dockerfile`: Container config
+- `.huggingface.yaml`: Space metadata
+- `README.md`: Docs