Update README.md

README.md

@@ -11,5 +11,92 @@ pinned: false
 license: mit
 short_description: 'Vajra-ISA (वज्र-ISA) उद्दिष्ट: वैदिक त्रिगुण (तम-रज-सत्व) '
 ---
+# Vajra-ISA (वज्र-ISA)
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+Vedic-inspired Virtual Machine for Neuro-Symbolic AI and Interpretable AI.
+
+## Overview
+
+Vajra-ISA is a Turing-complete, FP32-based virtual machine inspired by the Vedic tri-guṇa (तम-रज-सत्व) framework. It serves as a low-level language for:
+
+- **Neuro-Symbolic AI**: Write interpretable neural programs
+- **Indic Knowledge Systems**: Load Vedic concepts as data
+- **Interpretable AI**: Every instruction maps to natural language explanation
+
+## Architecture
+
+### Register File (त्रिगुण Model)
+
+| Register | गुण   | Role                          |
+|----------|--------|-------------------------------|
+| R0       | तम     | Accumulator / Activation      |
+| R1       | रज     | Operand / Gradient            |
+| R2       | सत्व   | Flag / Decision gate          |
+| R3       | गति    | Program Counter               |
+| R4       | स्मृती | Stack Pointer                 |
+
+### Instruction Set
+
+32-bit format: `[8-bit Opcode | 24-bit Operand]`
+
+Key instructions:
+- **Data**: `तम`, `स्थिर`, `कर्म`
+- **ALU**: `रज_जो`, `रज_वि`, `रज_गु`, `योग`
+- **Control**: `सत्व`, `माया`, `गति`, `काल`
+- **AI Core**: `ध्यान` (soft normalization)
+- **System**: `ब्रह्म` (halt)
+
+## Usage
+
+### Online (Hugging Face Space)
+
+Visit: [Your Space URL]
+
+### Local
+
+```bash
+pip install -r requirements.txt
+python app.py
+```
+
+### Example Program
+
+```vajra
+; Simple loop: sum 1 to 5
+    तम 0          ; R0 = 0 (accumulator)
+    तम 5          ; R0 = 5 (counter)
+गति_लूप:
+    रज_जो         ; R0 = R0 + R1
+    काल गति_लूप   ; R0-- ; if R0>0 goto गति_लूप
+    ब्रह्म
+```
+
+## Hugging Face Integration
+
+Load Vedic concepts from datasets:
+
+```vajra
+%load_geometry "पुष्पक_विमान"
+
+    स्थिर पुष्पक_विमान_satva
+    ; R0 = satva value from dataset
+```
+
+Dataset: `kalpesh77/vedic-neural-geometry`
+
+## Development Status
+
+- ✅ Virtual Machine (CPU)
+- ✅ Assembler (Lexer + Parser)
+- ✅ Linker (HF Dataset integration)
+- ✅ Gradio UI
+- 🔜 Compiler (Vajra → PyTorch graphs)
+- 🔜 More AI instructions
+
+## License
+
+MIT
+
+## Author
+
+Kalpesh