From e30fc3dc1200d0f3d4e77b12a56760a40ead3dd5 Mon Sep 17 00:00:00 2001 From: spomichter Date: Tue, 3 Mar 2026 17:04:50 +0000 Subject: [PATCH 1/2] docs: compact system requirements table, move details to docs/requirements.md --- README.md | 33 ++++++++------------------ docs/requirements.md | 56 ++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 66 insertions(+), 23 deletions(-) create mode 100644 docs/requirements.md diff --git a/README.md b/README.md index e07d623300..4b62dbb6ab 100644 --- a/README.md +++ b/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 | 50 GB SSD | 100 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 diff --git a/docs/requirements.md b/docs/requirements.md new file mode 100644 index 0000000000..df8c23a5c8 --- /dev/null +++ b/docs/requirements.md @@ -0,0 +1,56 @@ +# 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 + +- **50GB+ free disk space** +- SSD strongly recommended for model loading and data logging +- 100GB+ recommended if running multiple models or recording datasets + +## 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 +``` From 35a935c91e0f8656203967aa1706e9b706ce3138 Mon Sep 17 00:00:00 2001 From: spomichter Date: Tue, 3 Mar 2026 19:21:59 +0000 Subject: [PATCH 2/2] docs: correct disk requirements to 10GB min / 25GB recommended --- README.md | 2 +- docs/requirements.md | 5 +++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 4b62dbb6ab..9194529dea 100644 --- a/README.md +++ b/README.md @@ -136,7 +136,7 @@ Dimensional is agent native -- "vibecode" your robots in natural language and bu | GPU | NVIDIA RTX 3000+ (8GB VRAM) | RTX 4070+ (12GB+ VRAM) | | CPU | 8-core Intel/AMD | 12+ cores | | RAM | 16 GB | 32 GB+ | -| Disk | 50 GB SSD | 100 GB+ SSD | +| 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. diff --git a/docs/requirements.md b/docs/requirements.md index df8c23a5c8..010dc51751 100644 --- a/docs/requirements.md +++ b/docs/requirements.md @@ -27,9 +27,10 @@ DimOS may run on older hardware (e.g., NVIDIA 3000-series GPUs), but performance ## Storage -- **50GB+ free disk space** +- **10GB+ free disk space** (library install) - SSD strongly recommended for model loading and data logging -- 100GB+ recommended if running multiple models or recording datasets +- 25GB+ recommended for developer mode (full git history includes LFS assets) +- 50GB+ if recording datasets or running multiple large models ## Operating System