Update README.md

README.md

@@ -1,3 +1,56 @@
----
-license: odbl
----
+---
+license: mit
+language:
+- en
+tags:
+- crypto
+- terminal
+- dashboard
+- swarm
+- nanobots
+- inference
+- huggingface
+pipeline_tag: text-generation
+library_name: nextjs
+---
+
+# SWARMDX // Nano-Swarm Intel Console
+
+> **A hacker-style terminal that simulates a nano-swarm of micro-bots** to transform raw crypto text into structured intel: **summary, keywords, claims, risks, glossary, and a final memo**.
+
+**Status:** `ALPHA`  
+**UI Theme:** terminal / scanlines / neon grid  
+**Inference:** Hugging Face Router (optional) + mock mode fallback
+
+---
+
+## ⚡ What is SWARMDX?
+
+SWARMDX is a **visual-first research console**.  
+You paste a tweet / announcement / thesis and **deploy a swarm** of nano-units:
+
+- **Scout** → detects topic + context
+- **Narrative** → extracts keywords/themes
+- **Claim** → lists explicit assertions
+- **Risk** → flags hype / urgency / gaps (text-only evidence)
+- **Glossary** → defines key terms
+- **Assembler** → compiles a clean terminal memo
+
+No live market data. No buy/sell calls. Pure **text intelligence**.
+
+---
+
+## 🧠 Demo Output Contract (JSON)
+
+SWARMDX expects this structure from inference:
+
+```json
+{
+  "summary": "string",
+  "keywords": ["string"],
+  "claims": ["string"],
+  "risks": ["string"],
+  "glossary": [{"term":"string","def":"string"}],
+  "checklist": ["string"],
+  "final_memo": "string"
+}