robot_assets: put the CAD toolchain behind a cad extra

README.md

@@ -99,7 +99,7 @@ the finalize stage idempotent and the MJCF rooted at the CAD root link.
 ## Re-generating from CAD
 
 ```bash
-uv sync
+uv sync --extra cad
 sudo apt install openscad        # for collider editing (onshape-to-robot)
 ```
 

pyproject.toml

@@ -8,7 +8,10 @@ version = "0.3.1"
 description = "Robot asset tool: generate URDF / MJCF / xacro from Onshape CAD, and load robot descriptions"
 readme = "README.md"
 requires-python = ">=3.10"
-dependencies = [
+dependencies = []
+
+[project.optional-dependencies]
+cad = [
     "mujoco>=3.4.0",
     "onshape-to-robot>=1.8.0",
     "pymeshlab>=2025.7.post1",
@@ -26,6 +29,7 @@ robot-assets-urdf-to-xacro = "robot_assets.workflow.urdf_to_xacro:main"
 [dependency-groups]
 test = [
     "pytest>=8.0",
+    "robot-assets[cad]",
 ]
 
 [tool.pytest.ini_options]

robot_assets/workflow/onshape_to_urdf.py

@@ -26,8 +26,18 @@
 
 
 def _onshape_to_robot_bin() -> str:
-    """Locate the onshape-to-robot CLI (PATH, else alongside the running interpreter)."""
-    return shutil.which("onshape-to-robot") or str(Path(sys.executable).parent / "onshape-to-robot")
+    """Locate the onshape-to-robot CLI (PATH, else alongside the running interpreter).
+
+    Raises:
+        FileNotFoundError: If the CLI is missing, i.e. the `cad` extra is not installed.
+    """
+    binary = shutil.which("onshape-to-robot") or str(Path(sys.executable).parent / "onshape-to-robot")
+    if not Path(binary).exists():
+        raise FileNotFoundError(
+            "The onshape-to-robot CLI was not found. It ships with the CAD toolchain rather than "
+            "the base install; install it with `pip install robot-assets[cad]`."
+        )
+    return binary
 
 
 def export(robot_dir: Path, *, keep_assets: bool = False, convert: bool = False) -> Path:

robot_assets/workflow/urdf_to_mjcf.py

@@ -20,7 +20,13 @@
 import tempfile
 import xml.etree.ElementTree as ET
 
-import mujoco
+try:
+    import mujoco
+except ModuleNotFoundError as error:
+    raise ModuleNotFoundError(
+        "MuJoCo is needed to compile MJCF, and ships with the CAD toolchain rather than the "
+        "base install. Install it with `pip install robot-assets[cad]`."
+    ) from error
 
 from . import robot_model