docs: compact system requirements into table, move details to docs/

README.md

@@ -131,29 +131,16 @@ Dimensional is agent native -- "vibecode" your robots in natural language and bu
 
 # System Requirements
 
-## Tested and Supported Hardware
-
-DimOS has been tested and validated on the following hardware configurations:
-
-### GPU
-- **NVIDIA RTX 4070 or better** (for perception, VLMs, and AI features)
-- CUDA support required
-- Minimum 8GB VRAM recommended
-
-### CPU
-- **Intel Core i7 (recent generation) or better**
-- AMD Ryzen 7 or better
-- Multi-core recommended for distributed execution
-
-### Memory
-- **16GB RAM minimum**
-- 32GB+ recommended for larger models and multi-robot deployments
-
-### Storage
-- **50GB+ free disk space**
-- SSD strongly recommended for model loading and data logging
-
-> **Note:** DimOS may run on older hardware (e.g., NVIDIA 3000-series GPUs), but performance and stability are not guaranteed. If you encounter issues, please upgrade to the recommended specifications above.
+| Component | Minimum | Recommended |
+|-----------|---------|-------------|
+| GPU | NVIDIA RTX 3000+ (8GB VRAM) | RTX 4070+ (12GB+ VRAM) |
+| CPU | 8-core Intel/AMD | 12+ cores |
+| RAM | 16 GB | 32 GB+ |
+| Disk | 10 GB SSD | 25 GB+ SSD |
+| OS | Ubuntu 22.04, macOS 12.6+ | Ubuntu 24.04 |
+
+> GPU is optional for basic robot control. Required for perception, VLMs, and AI features.
+> Full details: [docs/requirements.md](docs/requirements.md)
 
 # Installation
 

docs/requirements.md

@@ -0,0 +1,57 @@
+# System Requirements
+
+Detailed hardware and software requirements for running DimOS.
+
+## GPU
+
+- **NVIDIA RTX 4070 or better** (for perception, VLMs, and AI features)
+- CUDA support required
+- Minimum 8GB VRAM recommended
+- 12GB+ VRAM recommended for larger vision-language models
+
+DimOS may run on older hardware (e.g., NVIDIA 3000-series GPUs), but performance and stability are not guaranteed. If you encounter issues, please upgrade to the recommended specifications.
+
+> **GPU is optional** for basic robot control, teleoperation, and non-AI workflows. It is required for perception pipelines, VLMs, and AI-driven features.
+
+## CPU
+
+- **Intel Core i7 (recent generation) or better**
+- AMD Ryzen 7 or better
+- 8+ cores minimum, 12+ cores recommended
+- Multi-core strongly recommended for distributed execution and multi-robot deployments
+
+## Memory
+
+- **16GB RAM minimum**
+- 32GB+ recommended for larger models and multi-robot deployments
+
+## Storage
+
+- **10GB+ free disk space** (library install)
+- SSD strongly recommended for model loading and data logging
+- 25GB+ recommended for developer mode (full git history includes LFS assets)
+- 50GB+ if recording datasets or running multiple large models
+
+## Operating System
+
+- **Ubuntu 22.04 / 24.04** (primary supported platform)
+- **macOS 12.6+** (beta support)
+- NixOS / general Linux (via Nix flake)
+
+## Tested Configurations
+
+| Config | GPU | CPU | RAM | Status |
+|--------|-----|-----|-----|--------|
+| Dev workstation | RTX 4090 (24GB) | i9-13900K | 64GB | ✅ Primary dev |
+| Mid-range | RTX 4070 (12GB) | i7-12700 | 32GB | ✅ Tested |
+| Laptop | RTX 4060 Mobile (8GB) | i7-13700H | 16GB | ✅ Tested |
+| Headless server | No GPU | Xeon | 32GB | ✅ Control only |
+| Jetson Orin | Orin (8GB shared) | ARM A78AE | 16GB | 🟧 Experimental |
+
+## Headless / Server Environments
+
+If running on a headless Ubuntu server (no display), install OpenGL libraries for visualization dependencies:
+
+```bash
+sudo apt-get install -y libgl1 libegl1
+```