Release v0.0.9

.dockerignore

@@ -43,7 +43,7 @@ build/
 .env.local
 .env.*.local
 
-# Large data files
+# Large data files (LFS archives only)
 data/*
 !data/.lfs/
 

.github/workflows/code-cleanup.yml

@@ -1,8 +1,7 @@
 name: code-cleanup
 on:
   push:
-    paths-ignore:
-      - '**.md'
+  pull_request:
 
 permissions:
   contents: write

.gitignore

@@ -54,6 +54,7 @@ yolo11n.pt
 # symlink one of .envrc.* if you'd like to use
 .envrc
 .claude
+**/CLAUDE.md
 .direnv/
 
 /logs

README.md

@@ -6,7 +6,7 @@
 
 <br>
 
-[![Discord](https://img.shields.io/discord/1341146487186391173?style=flat-square&logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/8m6HMArf)
+[![Discord](https://img.shields.io/discord/1341146487186391173?style=flat-square&logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/dimos)
 [![Stars](https://img.shields.io/github/stars/dimensionalOS/dimos?style=flat-square)](https://github.com/dimensionalOS/dimos/stargazers)
 [![Forks](https://img.shields.io/github/forks/dimensionalOS/dimos?style=flat-square)](https://github.com/dimensionalOS/dimos/fork)
 [![Contributors](https://img.shields.io/github/contributors/dimensionalOS/dimos?style=flat-square)](https://github.com/dimensionalOS/dimos/graphs/contributors)
@@ -45,7 +45,7 @@ Core Features:
   test dimensional applications in real-time. Control your robot via waypoint, agent query, keyboard,
   VR, more.
 - **Modules:** Standalone components (equivalent to ROS nodes) that publish and subscribe to typed
-  In/Out streams that communicate over DimOS transports. The building blocks of Dimensional.
+  In/Out streams that communicate over DimOS transports. The primary components of Dimensional.
 - **Agents (experimental):** DimOS agents understand physical space, subscribe to sensor streams, and call
   **physical** tools. Emergence appears when agents have physical agency.
 - **MCP (experimental):** Vibecode robots by giving your AI editor (Cursor, Claude Code) MCP access to run
@@ -71,9 +71,9 @@ Supported/tested matrix:
 | Platform | Status | Tested | Required System deps |
 | --- | --- | --- | --- |
 | Linux | supported | Ubuntu 22.04, 24.04 | See below |
-| macOS | experimental beta | not CI-tested | `brew install gnu-sed gcc portaudio git-lfs libjpeg-turbo python` |
+| macOS | experimental beta | not CI-tested | `brew install gnu-sed gcc portaudio git-lfs libjpeg-turbo python; export ARCHFLAGS="-arch $(uname -m)"` |
 
-Note: macOS is usable but expect inconsistent/flaky behavior (rather than hard errors/crashes).
+Note: macOS is usable but expect inconsistent/flaky behavior (rather than hard errors/crashes). Setting `ARCHFLAGS` is likely optional, but some systems it is required to avoid a `clang` error.
 
 ```sh
 sudo apt-get update
@@ -152,7 +152,7 @@ from dimos.core import In, Module, Out, rpc
 from dimos.core.blueprints import autoconnect
 from dimos.msgs.geometry_msgs import Twist
 from dimos.msgs.sensor_msgs import Image
-from dimos.msgs.sensor_msgs.image_impls.AbstractImage import ImageFormat
+from dimos.msgs.sensor_msgs.Image import ImageFormat
 
 class RobotConnection(Module):
     cmd_vel: In[Twist]
@@ -189,7 +189,7 @@ if __name__ == "__main__":
 ### Blueprints
 
 Blueprints are how robots are constructed on Dimensional; instructions for how to construct and wire modules. You compose them with
-`autoconnect(...)`, which connects streams by `(name, type)` and returns a `ModuleBlueprintSet`.
+`autoconnect(...)`, which connects streams by `(name, type)` and returns a `Blueprint`.
 
 Blueprints can be composed, remapped, and have transports overridden if `autoconnect()` fails due to conflicting variable names or `In[]` and `Out[]` message types.
 

bin/dev

@@ -1,43 +1,43 @@
 #!/usr/bin/env bash
 REPO_ROOT=$(git rev-parse --show-toplevel)
 REL_PATH=$(realpath --relative-to="$REPO_ROOT" "$(pwd)")
-IMAGE="ghcr.io/dimensionalos/dev"
-IMAGE_NAME="$IMAGE:dev"
+IMAGE="ghcr.io/dimensionalos/ros-dev"
+IMAGE_TAG="$IMAGE:dev"
 
 image_exists() {
-    docker image inspect "${IMAGE_NAME}" &>/dev/null
+    docker image inspect "${IMAGE_TAG}" &>/dev/null
 }
 
 image_pull() {
-    docker pull "$IMAGE_NAME"
+    docker pull "$IMAGE_TAG"
 }
 
 ensure_image_downloaded() {
     if ! image_exists "$1"; then
-        echo "Image ${IMAGE_NAME} not found. Pulling..."
+        echo "Image ${IMAGE_TAG} not found. Pulling..."
         image_pull "$1"
     fi
 }
 
 check_image_running() {
-    if docker ps -q --filter "ancestor=${IMAGE_NAME}" | grep -q .; then
+    if docker ps -q --filter "ancestor=${IMAGE_TAG}" | grep -q .; then
         return 0
     else
         return 1
     fi
 }
 
 stop_image() {
-    if check_image_running ${IMAGE_NAME}; then
-        echo "Stopping containers from image ${IMAGE_NAME}..."
-        docker stop $(docker ps -q --filter "ancestor=${IMAGE_NAME}")
+    if check_image_running ${IMAGE_TAG}; then
+        echo "Stopping containers from image ${IMAGE_TAG}..."
+        docker stop $(docker ps -q --filter "ancestor=${IMAGE_TAG}")
     else
-        echo "No containers from image ${IMAGE_NAME} are running."
+        echo "No containers from image ${IMAGE_TAG} are running."
     fi
 }
 
 
-get_tag() {
+get_branch_tag() {
     local branch_name
     branch_name=$(git rev-parse --abbrev-ref HEAD)
 
@@ -58,16 +58,16 @@ get_tag() {
 
 build_image() {
     local image_tag
-    image_tag=$(get_tag)
+    image_tag=$(get_branch_tag)
 
     docker build \
         --build-arg GIT_COMMIT=$(git rev-parse --short HEAD) \
         --build-arg GIT_BRANCH=$(git rev-parse --abbrev-ref HEAD) \
-        -t "ghcr.io/dimensionalos/dev:${image_tag}" -f docker/dev/Dockerfile .
+        -t "ghcr.io/dimensionalos/ros-dev:${image_tag}" -f docker/dev/Dockerfile .
 }
 
 remove_image() {
-    local tag=$(get_tag)
+    local tag=$(get_branch_tag)
     docker rm -f "dimos-dev-${tag}" 2>/dev/null || true
 }
 
@@ -141,7 +141,7 @@ else
             shift
             ;;
         pull)
-            docker pull ghcr.io/dimensionalos/dev:dev
+            docker pull "${IMAGE_TAG}"
             shift
             ;;
         *)

bin/doclinks

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+python "$REPO_ROOT/dimos/utils/docs/doclinks.py" "$@"

dimos/agents/__init__.py

@@ -1,12 +1,3 @@
-from langchain_core.messages import (
-    AIMessage,
-    HumanMessage,
-    MessageLikeRepresentation,
-    SystemMessage,
-    ToolCall,
-    ToolMessage,
-)
-
 from dimos.agents.agent import Agent, deploy
 from dimos.agents.spec import AgentSpec
 from dimos.agents.vlm_agent import VLMAgent

dimos/agents/skills/demo_gps_nav.py

@@ -24,7 +24,7 @@
 load_dotenv()
 
 
-demo_gps_nav_skill = autoconnect(
+demo_gps_nav = autoconnect(
     demo_robot(),
     gps_nav_skill(),
     human_input(),