Add Space README with setup instructions

README.md

@@ -1,15 +1,29 @@
 ---
+title: NEXUS OS v2.1
+emoji: 🔥
+colorFrom: red
+colorTo: purple
 sdk: gradio
-title: Nexus Os Space
-emoji: 📉
-colorFrom: blue
-colorTo: yellow
-sdk_version: 6.14.0
-python_version: '3.13'
+sdk_version: 4.0.0
 app_file: app.py
 pinned: false
-tags:
-- ml-intern
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# NEXUS OS v2.1 — Thermodynamic LLM Control System
+
+Hybrid Cloud + Local Inference with BEC Thermodynamic Hallucination Control.
+
+## Features
+- **37+ real models** including Nemotron-3 Nano-Omni 30B and OpenSonnet-Lite-MAX
+- **Ollama relay** — connect your local Ollama via ngrok/tunnel
+- **Cloud API fallback** — DeepSeek, Claude, GPT-5, Qwen, Kimi, GLM
+- **4 hallucination detectors** (EPR, Spilled Energy, CK-PLUG, TWAVE)
+- **Novel composite signals**: EEP, PTI, NEWI
+
+## Setup
+1. Expose your local Ollama: `ngrok http 11434`
+2. Set `OLLAMA_RELAY_URL` in Space secrets
+3. Add cloud API keys as needed
+
+## Repository
+[specimba/nexus-os-v2](https://huggingface.co/datasets/specimba/nexus-os-v2)