Update README.md

README.md

@@ -1,10 +1,130 @@
 ---
-title: README
-emoji: 🏢
-colorFrom: yellow
-colorTo: purple
+title: Matrix.Corp
+emoji: 🐦‍🔥
+colorFrom: indigo
+colorTo: pink
 sdk: static
-pinned: false
+pinned: true
 ---
 
-Edit this `README.md` markdown file to author your organization card.
+# Matrix.Corp 🚀
+
+Welcome to **Matrix.Corp** — an independent AI research organization building specialized language models for real-world use cases.
+
+---
+
+## Our Philosophy
+
+We believe AI models should be **purpose-built**, not one-size-fits-all. Every model in our family is designed from the ground up for a specific domain, user, and hardware target. We focus on novel architectures, hardware-aware optimization, and emotional intelligence across all our models.
+
+---
+
+## Model Families
+
+### 🌌 Zenith — Reasoning & Emotional Intelligence
+*Optimized for Tenstorrent Blackhole p300a hardware*
+
+High-performance reasoning models built for the Tenstorrent p300a accelerator (dual-chip, 32 RISC-V cores, 64GB GDDR6). Each model features Ring Attention (32K context), Mixture of Experts, and our EQ Engine for emotional intelligence.
+
+| Model | Parameters | Base Model | Status | Use Case |
+|---|---|---|---|---|
+| [Zenith-7B-V1](https://huggingface.co/Matrix-Corp/Zenith-7b-V1) | 7B | Qwen2.5-Coder-7B | 🟡 Preview | Code generation, fast inference |
+| [Zenith-28B-V1](https://huggingface.co/Matrix-Corp/Zenith-28b-p300-V1) | 28B | Qwen3.5-27B (Claude Opus 4.6 distilled) | 🟡 Preview | Nuanced reasoning, EQ-aware conversations |
+| [Zenith-32B-V1](https://huggingface.co/Matrix-Corp/Zenith-32b-V1-Tenstorrent-Blackhole-p300) | 32B | DeepSeek-R1-Distill-Qwen-32B | 🟡 Preview | Mathematical & structured reasoning |
+| [Zenith-70B-V1](https://huggingface.co/Matrix-Corp/Zenith-70b-V1-Tenstorrent-Blackhole-p300) | 70B | DeepSeek-R1-Distill-Llama-70B | 🟡 Preview | Maximum capability, multi-card setup |
+
+**Key features:**
+- 🧠 EQ Engine — frustration detection + 8-emotion classification, fully integrated as core architecture (V1)
+- ⚡ Ring Attention — 32K context on limited memory
+- 🔀 Mixture of Experts — 12 experts, top-2 routing
+- 🖥️ p300a optimized — TP=8/PP=4 maps 1:1 to all 32 RISC-V cores
+- 📦 Ollama + vLLM compatible
+
+**Timeline:** Trained weights + real benchmarks expected in 3–6 months
+
+---
+
+### 🔬 Vortex Scientific — Deep Science Reasoning
+*Optimized for Apple Silicon & Nvidia 4060 laptop GPUs*
+
+From-scratch models built for scientific reasoning across Physics, Mathematics, Chemistry, Biology, Earth Science, Space Science, and Zoology. Novel hybrid state-space + attention architecture with specialized science modules.
+
+| Model | Parameters | Architecture | Status | Use Case |
+|---|---|---|---|---|
+| [Vortex-7B-V1](https://huggingface.co/Matrix-Corp/Vortex-7b-V1) | 7B | Hybrid SSM + Attention (60% SSM) | 🟡 Preview | Science reasoning on consumer hardware |
+| [Vortex-13B-V1](https://huggingface.co/Matrix-Corp/Vortex-13b-V1) | 13B | Hybrid SSM + Attention (50% SSM) | 🟡 Preview | Advanced scientific reasoning |
+
+**Key features:**
+- 🔭 No base model — built entirely from scratch including tokenizer
+- ⚗️ Science modules — Equation/LaTeX, Numerical Reasoning, Citation Awareness, Molecular/Periodic Table
+- 📐 Custom science tokenizer — 50K vocab with LaTeX symbols, element symbols, SI units, amino acids
+- 🖥️ Laptop-first — runs on MacBook Pro M2/M3 and Nvidia 4060
+- 🎓 School science project
+
+**Timeline:** Training data pipeline in progress, weights TBD
+
+---
+
+### 🌿 Touch Grass — Music AI Assistant
+*Ultra lightweight, runs on anything*
+
+Fine-tuned music assistant helping users learn instruments, understand music theory, write songs, train their ear, and explore music history. Warm, encouraging, beginner-friendly.
+
+| Model | Parameters | Base Model | Status | Use Case |
+|---|---|---|---|---|
+| TouchGrass-3B | 3B | Qwen3.5-3B-Instruct | 🔴 Planned | Ultra lightweight music assistant |
+| TouchGrass-7B | 7B | Qwen3.5-7B-Instruct | 🔴 Planned | Full-featured music assistant |
+
+**Key features:**
+- 🎸 All instruments — Guitar, Bass, Piano, Keys, Drums, Vocals, DJ & Production
+- 🎵 Tab & chord generation — structured, musically validated output
+- 🎼 Music theory engine — circle of fifths, modes, progressions, voice leading
+- 👂 Ear training guidance — interval recognition, chord quality, relative pitch
+- ✍️ Songwriting assistant — lyrics, progressions, structure, hooks
+- 💚 Music EQ adapter — frustration detection tuned for music learners
+- 📖 Genre & music history knowledge
+
+**Timeline:** In planning, build starting soon
+
+---
+
+## Status Legend
+
+| Status | Meaning |
+|---|---|
+| 🟢 Released | Trained weights available, benchmarks published |
+| 🟡 Preview | Architecture and code published, training in progress |
+| 🔴 Planned | Design complete, build not yet started |
+
+---
+
+## Hardware Philosophy
+
+We build for **accessible, affordable hardware** — not just cloud GPUs:
+
+| Series | Target Hardware | Why |
+|---|---|---|
+| Zenith | Tenstorrent p300a | High-performance AI at a fraction of Nvidia cost |
+| Vortex | MacBook + 4060 laptop | Science AI for researchers and students anywhere |
+| Touch Grass | Any hardware | Music assistance should be universally accessible |
+
+---
+
+## Organization
+
+**Matrix.Corp** is an independent AI research organization.
+
+- 👤 Founded by [Zandy-Wandy](https://huggingface.co/Zandy-Wandy)
+- 🐙 GitHub: [zapgaming](https://github.com/zapgaming)
+- 🤗 HuggingFace: [Matrix-Corp](https://huggingface.co/Matrix-Corp)
+
+---
+
+## Collections
+
+- [Zenith V1](https://huggingface.co/collections/Matrix-Corp/zenith-v1) — All Zenith series models
+- [Vortex V1](https://huggingface.co/collections/Matrix-Corp/vortex-v1) — All Vortex series models
+
+---
+
+*Building specialized AI, one model at a time.* 🚀