[Convenience PR / branch: all of the docs / all of YM's changes]

.devcontainer/devcontainer.json

@@ -0,0 +1,32 @@
+{
+  "name": "dimos-dev",
+  "image": "ghcr.io/dimensionalos/dev:dev",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "charliermarsh.ruff",
+        "ms-python.vscode-pylance"
+      ]
+    }
+  },
+  "containerEnv": {
+    "PYTHONPATH": "${localEnv:PYTHONPATH}:/workspaces/dimos"
+  },
+  "postCreateCommand": "git config --global --add safe.directory /workspaces/dimos && cd /workspaces/dimos && pre-commit install",
+  "settings": {
+    "notebook.formatOnSave.enabled": true,
+    "notebook.codeActionsOnSave": {
+      "notebook.source.fixAll": "explicit",
+      "notebook.source.organizeImports": "explicit"
+    },
+    "editor.codeActionsOnSave": {
+      "source.fixAll": "explicit",
+      "source.organizeImports": "explicit"
+    },
+    "editor.defaultFormatter": "charliermarsh.ruff",
+    "editor.formatOnSave": true
+  },
+  "runArgs": [
+    "--cap-add=NET_ADMIN"
+  ]
+}

.dockerignore

@@ -0,0 +1,109 @@
+# Version control
+.git
+.gitignore
+.github/
+
+# Editor and IDE files
+.vscode
+.idea
+*.swp
+*.swo
+.cursor/
+.cursorignore
+
+# Shell history
+.bash_history
+.zsh_history
+.history
+
+# Python virtual environments
+**/venv/
+**/.venv/
+**/env/
+**/.env/
+**/*-venv/
+**/*_venv/
+**/ENV/
+
+
+# Python build artifacts
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+*.so
+*.dylib
+
+# Environment file
+.env
+.env.local
+.env.*.local
+
+# Large data files
+data/*
+!data/.lfs/
+
+# Model files (can be downloaded at runtime)
+*.pt
+*.pth
+*.onnx
+*.pb
+*.h5
+*.ckpt
+*.safetensors
+checkpoints/
+assets/model-cache
+
+# Logs
+*.log
+
+# Large media files (not needed for functionality)
+*.png
+*.jpg
+*.jpeg
+*.gif
+*.mp4
+*.mov
+*.avi
+*.mkv
+*.webm
+*.MOV
+
+# Large font files
+*.ttf
+*.otf
+
+# Node modules (for dev tools, not needed in container)
+node_modules/
+package-lock.json
+package.json
+bin/node_modules/
+
+# Database files
+*.db
+*.sqlite
+*.sqlite3
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+.python-version
+
+# Exclude all assets subdirectories
+assets/*/*
+!assets/agent/prompt.txt
+!assets/*

.editorconfig

@@ -0,0 +1,27 @@
+# top-most EditorConfig file
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+indent_size = 4
+
+[*.nix]
+indent_size = 2
+
+[*.{py,ipynb}]
+indent_size = 4
+max_line_length = 100
+
+[*.rs]
+indent_style = space
+indent_size = 4
+
+[*.{ts,svelte}]
+indent_size = 2

.envrc.nix

@@ -0,0 +1,11 @@
+if ! has nix_direnv_version || ! nix_direnv_version 3.0.6; then
+  source_url "https://raw.githubusercontent.com/nix-community/nix-direnv/3.0.6/direnvrc" "sha256-RYcUJaRMf8oF5LznDrlCXbkOQrywm0HDv1VjYGaJGdM="
+fi
+use flake .
+for venv in venv .venv env; do
+  if [[ -f "$venv/bin/activate" ]]; then
+    source "$venv/bin/activate"
+    break
+  fi
+done
+dotenv_if_exists

.envrc.venv

@@ -0,0 +1,7 @@
+for venv in venv .venv env; do
+  if [[ -f "$venv/bin/activate" ]]; then
+    source "$venv/bin/activate"
+    break
+  fi
+done
+dotenv_if_exists

.gitattributes

@@ -1,3 +1,16 @@
-* text=auto
+# Handle line endings automatically for files Git considers text,
+# converting them to LF on checkout.
+* text=auto eol=lf
+# Ensure Python files always use LF for line endings.
 *.py text eol=lf
-
+# Treat designated file types as binary and do not alter their contents or line endings.
+*.png binary
+*.jpg binary
+*.ico binary
+*.pdf binary
+# Explicit LFS tracking for test files
+/data/.lfs/*.tar.gz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text binary
+*.mp4 filter=lfs diff=lfs merge=lfs -text binary
+*.mov filter=lfs diff=lfs merge=lfs -text binary
+*.gif filter=lfs diff=lfs merge=lfs -text binary

.github/actions/docker-build/action.yml

@@ -0,0 +1,59 @@
+name: docker-build
+description: "Composite action to build and push a Docker target to GHCR"
+inputs:
+  target:
+    description: "Dockerfile target stage to build"
+    required: true
+  tag:
+    description: "Image tag to push"
+    required: true
+  freespace:
+    description: "Remove large pre‑installed SDKs before building to free space"
+    required: false
+    default: "false"
+  context:
+    description: "Docker build context"
+    required: false
+    default: "."
+
+runs:
+  using: "composite"
+  steps:
+    - name: Free up disk space
+      if: ${{ inputs.freespace == 'true' }}
+      shell: bash
+      run: |
+        echo -e "pre cleanup space:\n $(df -h)"
+        sudo rm -rf /opt/ghc
+        sudo rm -rf /usr/share/dotnet
+        sudo rm -rf /usr/local/share/boost
+        sudo rm -rf /usr/local/lib/android
+        echo -e "post cleanup space:\n $(df -h)"
+
+    - uses: actions/checkout@v4
+
+    - uses: docker/login-action@v3
+      with:
+        registry: ghcr.io
+        username: ${{ github.actor }}
+        password: ${{ github.token }}
+
+    - uses: crazy-max/ghaction-github-runtime@v3
+
+    - uses: docker/setup-buildx-action@v3
+      with:
+        driver: docker-container
+        install: true
+        use: true
+
+    - name: Build & Push ${{ inputs.target }}
+      uses: docker/build-push-action@v6
+      with:
+        push: true
+        context: ${{ inputs.context }}
+        file: docker/${{ inputs.target }}/Dockerfile
+        tags: ghcr.io/dimensionalos/${{ inputs.target }}:${{ inputs.tag }}
+        cache-from: type=gha,scope=${{ inputs.target }}
+        cache-to: type=gha,mode=max,scope=${{ inputs.target }}
+        build-args: |
+          FROM_TAG=${{ inputs.tag }}