strands-cad 0.3.0__tar.gz

strands_cad-0.3.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+build/
+dist/
+.pytest_cache/
+.venv/
+venv/
+.DS_Store
+*.stl
+*.3mf
+*.gcode
+*.bgcode
+!examples/*.stl
+!tests/fixtures/*.stl

strands_cad-0.3.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: strands-cad
+Version: 0.3.0
+Summary: 🔧 Atomic CAD, mesh, SDF, cadquery, neural & print tools for Strands agents — prompt-to-print pipeline
+Project-URL: Homepage, https://github.com/cagataycali/strands-cad
+Project-URL: Repository, https://github.com/cagataycali/strands-cad
+Project-URL: Issues, https://github.com/cagataycali/strands-cad/issues
+Author: Cagatay Cali
+License: MIT
+Keywords: 3d,3d-printing,3mf,agents,bambu,cad,cadquery,mesh,openscad,sdf,shap-e,stl,strands
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Requires-Dist: cadquery>=2.5
+Requires-Dist: fast-simplification>=0.1
+Requires-Dist: ipywidgets>=8.0
+Requires-Dist: meshio>=5.0
+Requires-Dist: mujoco>=3.0
+Requires-Dist: numpy>=1.24
+Requires-Dist: paho-mqtt>=2.0
+Requires-Dist: pillow>=10.0
+Requires-Dist: requests>=2.31
+Requires-Dist: scikit-image>=0.22
+Requires-Dist: scipy>=1.11
+Requires-Dist: strands-agents>=0.1.0
+Requires-Dist: torch>=2.0
+Requires-Dist: torchvision>=0.15
+Requires-Dist: trimesh>=4.0
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 🔧 strands-cad
+
+**Atomic CAD, mesh, SDF, cadquery, neural & print tools for [Strands](https://github.com/strands-agents) agents.**
+
+Four independent paths to a printable 3D asset:
+
+| Path | Tool | Best For |
+|---|---|---|
+| **Parametric SCAD** | `scad_render_stl` | Mechanical, brackets, parametric families |
+| **B-rep CAD (NURBS)** | `cq_render_stl` / `cq_render_step` | Fillets, chamfers, engineering-grade parts |
+| **SDF / implicit math** | `sdf_render_stl` | Organic, twisted, TPMS, blended surfaces |
+| **Neural (text/image → 3D)** | `neural_text_to_stl` | AI generation from prompt or reference photo |
+
+All roads lead to STL → 3MF → Bambu Lab.
+
+## Install
+
+```bash
+pip install strands-cad
+```
+
+Everything is a hard dependency — no extras needed. Includes:
+`trimesh, sdf (fogleman), cadquery, shap-e, torch, scikit-image, fast-simplification, mujoco, paho-mqtt, scipy, numpy, meshio`.
+
+**External** (system):
+- `openscad` for `scad_*` tools (`brew install openscad`)
+- `bambu-studio` for `slice_bambu` (bambulab.com)
+
+## The 51 Atomic Tools
+
+| Layer | Tools |
+|---|---|
+| **SCAD** (parametric) | `scad_probe`, `scad_render_stl`, `scad_render_png`, `scad_validate` |
+| **CadQuery** (B-rep, NURBS) | `cq_render_stl`, `cq_render_step`, `cq_import_step`, `cq_render_svg` |
+| **SDF** (implicit math) | `sdf_render_stl`, `sdf_list_primitives`, `sdf_gyroid_infill`, `sdf_from_function`, `sdf_lattice_infill_stl` |
+| **Neural** (AI generation) | `neural_text_to_stl`, `neural_image_to_stl` |
+| **Point Cloud** | `pointcloud_from_stl`, `pointcloud_to_stl`, `pointcloud_downsample` |
+| **STL / Mesh** | `stl_parse`, `stl_volume`, `stl_bbox`, `stl_weight`, `stl_repair`, `stl_transform`, `stl_convert`, `mesh_decimate`, `mesh_normalize`, `mesh_boolean`, `mesh_combine`, `mesh_hollow` |
+| **3MF** | `mf3_pack`, `mf3_unpack`, `mf3_read_metadata` |
+| **Slice** | `slice_bambu`, `slice_profile_get`, `slice_estimate` |
+| **Bambu Printer** | `bambu_connect`, `bambu_send`, `bambu_status`, `bambu_control`, `bambu_camera`, `bambu_ams` |
+| **Sim** | `sim_build_mjcf`, `sim_run_headless`, `sim_view_live`, `sim_inertia_from_stl` |
+| **Preview** | `preview_serve`, `preview_stop` |
+| **Meta** | `bom_parse`, `bom_total`, `journal_append` |
+
+## Quick Examples
+
+### Parametric CAD (CadQuery)
+```python
+from strands_cad import cq_render_stl
+
+cq_render_stl(script='''
+result = (
+    cq.Workplane("XY").box(60, 40, 5)
+    .edges().fillet(2)
+    .faces(">Z").hole(20)
+)
+''', output_stl="bracket.stl")
+```
+
+### Implicit Math (SDF)
+```python
+from strands_cad import sdf_render_stl
+
+sdf_render_stl(
+    expression="torus(30, 8).twist(radians(180)/60)",
+    output_stl="twisted_torus.stl",
+    resolution=0.4,
+)
+```
+
+### AI Text → 3D (Shap-E)
+```python
+from strands_cad import neural_text_to_stl
+
+neural_text_to_stl(
+    prompt="a stylized rocket ship",
+    output_stl="rocket.stl",
+    steps=64,
+)
+```
+
+### Full agent
+```python
+from strands import Agent
+from strands_cad import ALL_TOOLS
+
+agent = Agent(tools=ALL_TOOLS)
+agent("Generate a mechanical bracket with M4 mounting holes, "
+      "verify weight in PLA, and pack it for my Bambu P1S.")
+```
+
+## Design Principles
+
+- **Atomic** — one tool = one verb = one input shape = one output shape
+- **No orchestration** inside tools; the agent composes
+- **No hidden state** except the Bambu MQTT connection handle
+- **Standard response**: `{status, content: [{text}], ...extras}`
+
+## License
+
+MIT

strands_cad-0.3.0/README.md

@@ -0,0 +1,102 @@
+# 🔧 strands-cad
+
+**Atomic CAD, mesh, SDF, cadquery, neural & print tools for [Strands](https://github.com/strands-agents) agents.**
+
+Four independent paths to a printable 3D asset:
+
+| Path | Tool | Best For |
+|---|---|---|
+| **Parametric SCAD** | `scad_render_stl` | Mechanical, brackets, parametric families |
+| **B-rep CAD (NURBS)** | `cq_render_stl` / `cq_render_step` | Fillets, chamfers, engineering-grade parts |
+| **SDF / implicit math** | `sdf_render_stl` | Organic, twisted, TPMS, blended surfaces |
+| **Neural (text/image → 3D)** | `neural_text_to_stl` | AI generation from prompt or reference photo |
+
+All roads lead to STL → 3MF → Bambu Lab.
+
+## Install
+
+```bash
+pip install strands-cad
+```
+
+Everything is a hard dependency — no extras needed. Includes:
+`trimesh, sdf (fogleman), cadquery, shap-e, torch, scikit-image, fast-simplification, mujoco, paho-mqtt, scipy, numpy, meshio`.
+
+**External** (system):
+- `openscad` for `scad_*` tools (`brew install openscad`)
+- `bambu-studio` for `slice_bambu` (bambulab.com)
+
+## The 51 Atomic Tools
+
+| Layer | Tools |
+|---|---|
+| **SCAD** (parametric) | `scad_probe`, `scad_render_stl`, `scad_render_png`, `scad_validate` |
+| **CadQuery** (B-rep, NURBS) | `cq_render_stl`, `cq_render_step`, `cq_import_step`, `cq_render_svg` |
+| **SDF** (implicit math) | `sdf_render_stl`, `sdf_list_primitives`, `sdf_gyroid_infill`, `sdf_from_function`, `sdf_lattice_infill_stl` |
+| **Neural** (AI generation) | `neural_text_to_stl`, `neural_image_to_stl` |
+| **Point Cloud** | `pointcloud_from_stl`, `pointcloud_to_stl`, `pointcloud_downsample` |
+| **STL / Mesh** | `stl_parse`, `stl_volume`, `stl_bbox`, `stl_weight`, `stl_repair`, `stl_transform`, `stl_convert`, `mesh_decimate`, `mesh_normalize`, `mesh_boolean`, `mesh_combine`, `mesh_hollow` |
+| **3MF** | `mf3_pack`, `mf3_unpack`, `mf3_read_metadata` |
+| **Slice** | `slice_bambu`, `slice_profile_get`, `slice_estimate` |
+| **Bambu Printer** | `bambu_connect`, `bambu_send`, `bambu_status`, `bambu_control`, `bambu_camera`, `bambu_ams` |
+| **Sim** | `sim_build_mjcf`, `sim_run_headless`, `sim_view_live`, `sim_inertia_from_stl` |
+| **Preview** | `preview_serve`, `preview_stop` |
+| **Meta** | `bom_parse`, `bom_total`, `journal_append` |
+
+## Quick Examples
+
+### Parametric CAD (CadQuery)
+```python
+from strands_cad import cq_render_stl
+
+cq_render_stl(script='''
+result = (
+    cq.Workplane("XY").box(60, 40, 5)
+    .edges().fillet(2)
+    .faces(">Z").hole(20)
+)
+''', output_stl="bracket.stl")
+```
+
+### Implicit Math (SDF)
+```python
+from strands_cad import sdf_render_stl
+
+sdf_render_stl(
+    expression="torus(30, 8).twist(radians(180)/60)",
+    output_stl="twisted_torus.stl",
+    resolution=0.4,
+)
+```
+
+### AI Text → 3D (Shap-E)
+```python
+from strands_cad import neural_text_to_stl
+
+neural_text_to_stl(
+    prompt="a stylized rocket ship",
+    output_stl="rocket.stl",
+    steps=64,
+)
+```
+
+### Full agent
+```python
+from strands import Agent
+from strands_cad import ALL_TOOLS
+
+agent = Agent(tools=ALL_TOOLS)
+agent("Generate a mechanical bracket with M4 mounting holes, "
+      "verify weight in PLA, and pack it for my Bambu P1S.")
+```
+
+## Design Principles
+
+- **Atomic** — one tool = one verb = one input shape = one output shape
+- **No orchestration** inside tools; the agent composes
+- **No hidden state** except the Bambu MQTT connection handle
+- **Standard response**: `{status, content: [{text}], ...extras}`
+
+## License
+
+MIT

strands_cad-0.3.0/examples/quickstart.py

@@ -0,0 +1,18 @@
+"""Quickstart — spin up an agent with all strands-cad tools."""
+from strands import Agent
+from strands_cad import ALL_TOOLS
+
+agent = Agent(
+    tools=ALL_TOOLS,
+    system_prompt=(
+        "You are a 3D-printing assistant with atomic CAD/mesh/slice/print tools. "
+        "Compose the tools to accomplish the user's goal. "
+        "Every tool does one job — chain them yourself."
+    ),
+)
+
+if __name__ == "__main__":
+    # Example: "Analyze the STL at /tmp/part.stl and estimate its PLA weight."
+    import sys
+    q = " ".join(sys.argv[1:]) or "List every tool you have and one-line what each does."
+    print(agent(q))

strands_cad-0.3.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "strands-cad"
+version = "0.3.0"
+description = "🔧 Atomic CAD, mesh, SDF, cadquery, neural & print tools for Strands agents — prompt-to-print pipeline"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Cagatay Cali" }]
+keywords = ["3d", "cad", "openscad", "cadquery", "sdf", "shap-e", "3d-printing", "bambu", "mesh", "stl", "3mf", "strands", "agents"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Graphics :: 3D Modeling",
+    "Topic :: Scientific/Engineering",
+]
+
+dependencies = [
+    "strands-agents>=0.1.0",
+    # Core mesh
+    "numpy>=1.24",
+    "scipy>=1.11",
+    "trimesh>=4.0",
+    "scikit-image>=0.22",
+    "fast-simplification>=0.1",
+    # Real CAD (B-rep / NURBS)
+    "cadquery>=2.5",
+    # Neural helpers (Shap-E installed separately from git — see README)
+    "torch>=2.0",
+    "torchvision>=0.15",
+    "ipywidgets>=8.0",
+    "Pillow>=10.0",
+    # Sim
+    "mujoco>=3.0",
+    # Bambu printer control
+    "paho-mqtt>=2.0",
+    "requests>=2.31",
+    # Mesh IO
+    "meshio>=5.0",
+]
+
+# NOTE: `sdf` (fogleman) and `shap-e` (openai) are only on GitHub —
+# PyPI disallows direct git URLs, so users install them separately:
+#   pip install strands-cad
+#   pip install git+https://github.com/fogleman/sdf.git       # for SDF tools
+#   pip install git+https://github.com/openai/shap-e.git      # for neural tools
+# Or use the post-install helper: `python -m strands_cad.install_extras`
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pytest-cov", "build", "twine"]
+
+[project.urls]
+Homepage   = "https://github.com/cagataycali/strands-cad"
+Repository = "https://github.com/cagataycali/strands-cad"
+Issues     = "https://github.com/cagataycali/strands-cad/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["strands_cad"]

strands_cad-0.3.0/strands_cad/__init__.py

@@ -0,0 +1,40 @@
+"""strands-cad — atomic 3D tools for Strands agents."""
+__version__ = "0.3.0"
+
+from strands_cad.tools import (
+    scad_probe, scad_render_stl, scad_render_png, scad_validate,
+    stl_parse, stl_volume, stl_bbox, stl_weight, stl_repair,
+    stl_transform, stl_convert,
+    mesh_decimate, mesh_normalize, mesh_boolean, mesh_combine, mesh_hollow,
+    mf3_pack, mf3_unpack, mf3_read_metadata,
+    slice_bambu, slice_profile_get, slice_estimate,
+    bambu_connect, bambu_send, bambu_status, bambu_control,
+    bambu_camera, bambu_ams,
+    sim_build_mjcf, sim_run_headless, sim_view_live, sim_inertia_from_stl,
+    preview_serve, preview_stop,
+    bom_parse, bom_total, journal_append,
+    sdf_render_stl, sdf_list_primitives, sdf_gyroid_infill,
+    sdf_from_function, sdf_lattice_infill_stl,
+    cq_render_stl, cq_render_step, cq_import_step, cq_render_svg,
+    neural_text_to_stl, neural_image_to_stl,
+    pointcloud_from_stl, pointcloud_to_stl, pointcloud_downsample,
+)
+
+ALL_TOOLS = [
+    scad_probe, scad_render_stl, scad_render_png, scad_validate,
+    stl_parse, stl_volume, stl_bbox, stl_weight, stl_repair,
+    stl_transform, stl_convert,
+    mesh_decimate, mesh_normalize, mesh_boolean, mesh_combine, mesh_hollow,
+    mf3_pack, mf3_unpack, mf3_read_metadata,
+    slice_bambu, slice_profile_get, slice_estimate,
+    bambu_connect, bambu_send, bambu_status, bambu_control,
+    bambu_camera, bambu_ams,
+    sim_build_mjcf, sim_run_headless, sim_view_live, sim_inertia_from_stl,
+    preview_serve, preview_stop,
+    bom_parse, bom_total, journal_append,
+    sdf_render_stl, sdf_list_primitives, sdf_gyroid_infill,
+    sdf_from_function, sdf_lattice_infill_stl,
+    cq_render_stl, cq_render_step, cq_import_step, cq_render_svg,
+    neural_text_to_stl, neural_image_to_stl,
+    pointcloud_from_stl, pointcloud_to_stl, pointcloud_downsample,
+]

strands_cad-0.3.0/strands_cad/_common.py

@@ -0,0 +1,77 @@
+"""Shared utilities (STL parsing, response format)."""
+from __future__ import annotations
+import struct
+from pathlib import Path
+from typing import Any
+
+
+def ok(text: str, **extra: Any) -> dict:
+    """Standard success response."""
+    r = {"status": "success", "content": [{"text": text}]}
+    r.update(extra)
+    return r
+
+
+def err(text: str) -> dict:
+    """Standard error response."""
+    return {"status": "error", "content": [{"text": text}]}
+
+
+def parse_stl(path: str | Path):
+    """Parse binary or ASCII STL → (verts:list[tuple[float,float,float]], tris:list[tuple[int,int,int]]).
+
+    Deduplicates verts (rounded to 4 decimals).
+    """
+    p = Path(path)
+    if not p.exists():
+        raise FileNotFoundError(str(p))
+    with open(p, "rb") as f:
+        head = f.read(80)
+        rest = f.read(200).decode("latin-1", "ignore")
+        f.seek(0)
+        is_ascii = head.startswith(b"solid") and "facet" in rest
+        if is_ascii:
+            text = f.read().decode("ascii", errors="ignore")
+            verts, tris, v_map, current = [], [], {}, []
+            for line in text.splitlines():
+                s = line.strip()
+                if s.startswith("vertex"):
+                    x, y, z = map(float, s.split()[1:4])
+                    key = (round(x, 4), round(y, 4), round(z, 4))
+                    if key not in v_map:
+                        v_map[key] = len(verts)
+                        verts.append(key)
+                    current.append(v_map[key])
+                elif s.startswith("endfacet"):
+                    if len(current) == 3:
+                        tris.append(tuple(current))
+                    current = []
+            return verts, tris
+        # binary
+        f.seek(80)
+        n = struct.unpack("<I", f.read(4))[0]
+        verts, tris, v_map = [], [], {}
+        for _ in range(n):
+            f.read(12)  # normal
+            idx = []
+            for _ in range(3):
+                x, y, z = struct.unpack("<fff", f.read(12))
+                key = (round(x, 4), round(y, 4), round(z, 4))
+                if key not in v_map:
+                    v_map[key] = len(verts)
+                    verts.append(key)
+                idx.append(v_map[key])
+            f.read(2)  # attribute byte count
+            tris.append(tuple(idx))
+        return verts, tris
+
+
+def signed_volume_cm3(verts, tris) -> float:
+    """Signed-tetrahedron volume in cm³ (STL is in mm)."""
+    vol = 0.0
+    for a_i, b_i, c_i in tris:
+        a, b, c = verts[a_i], verts[b_i], verts[c_i]
+        vol += (a[0] * (b[1] * c[2] - b[2] * c[1])
+                - a[1] * (b[0] * c[2] - b[2] * c[0])
+                + a[2] * (b[0] * c[1] - b[1] * c[0])) / 6.0
+    return abs(vol) / 1000.0

strands_cad-0.3.0/strands_cad/install_extras.py

@@ -0,0 +1,33 @@
+"""Install optional git-only deps for strands-cad SDF + neural tools.
+
+Usage:
+    python -m strands_cad.install_extras           # install both
+    python -m strands_cad.install_extras sdf       # SDF only
+    python -m strands_cad.install_extras neural    # neural only
+"""
+import subprocess
+import sys
+
+EXTRAS = {
+    "sdf":    "git+https://github.com/fogleman/sdf.git",
+    "neural": "git+https://github.com/openai/shap-e.git",
+}
+
+
+def main():
+    which = sys.argv[1:] or list(EXTRAS.keys())
+    for name in which:
+        if name not in EXTRAS:
+            print(f"❌ unknown extra '{name}'. Options: {list(EXTRAS.keys())}")
+            sys.exit(1)
+        url = EXTRAS[name]
+        print(f"→ installing {name} from {url}")
+        rc = subprocess.call([sys.executable, "-m", "pip", "install", url])
+        if rc != 0:
+            print(f"❌ failed to install {name}")
+            sys.exit(rc)
+    print("✅ all requested extras installed")
+
+
+if __name__ == "__main__":
+    main()

strands_cad-0.3.0/strands_cad/tools/__init__.py

@@ -0,0 +1,44 @@
+"""Atomic tools for strands-cad."""
+from strands_cad.tools.scad import scad_probe, scad_render_stl, scad_render_png, scad_validate
+from strands_cad.tools.stl import (
+    stl_parse, stl_volume, stl_bbox, stl_weight, stl_repair, stl_transform, stl_convert,
+    mesh_decimate, mesh_normalize, mesh_boolean, mesh_combine, mesh_hollow,
+)
+from strands_cad.tools.mf3 import mf3_pack, mf3_unpack, mf3_read_metadata
+from strands_cad.tools.slice import slice_bambu, slice_profile_get, slice_estimate
+from strands_cad.tools.bambu import (
+    bambu_connect, bambu_send, bambu_status, bambu_control, bambu_camera, bambu_ams
+)
+from strands_cad.tools.sim import sim_build_mjcf, sim_run_headless, sim_view_live, sim_inertia_from_stl
+from strands_cad.tools.preview import preview_serve, preview_stop
+from strands_cad.tools.meta import bom_parse, bom_total, journal_append
+from strands_cad.tools.sdf_tools import (
+    sdf_render_stl, sdf_list_primitives, sdf_gyroid_infill,
+    sdf_from_function, sdf_lattice_infill_stl,
+)
+from strands_cad.tools.cadquery_tools import (
+    cq_render_stl, cq_render_step, cq_import_step, cq_render_svg,
+)
+from strands_cad.tools.neural_tools import (
+    neural_text_to_stl, neural_image_to_stl,
+    pointcloud_from_stl, pointcloud_to_stl, pointcloud_downsample,
+)
+
+__all__ = [
+    "scad_probe", "scad_render_stl", "scad_render_png", "scad_validate",
+    "stl_parse", "stl_volume", "stl_bbox", "stl_weight", "stl_repair",
+    "stl_transform", "stl_convert",
+    "mesh_decimate", "mesh_normalize", "mesh_boolean", "mesh_combine", "mesh_hollow",
+    "mf3_pack", "mf3_unpack", "mf3_read_metadata",
+    "slice_bambu", "slice_profile_get", "slice_estimate",
+    "bambu_connect", "bambu_send", "bambu_status", "bambu_control",
+    "bambu_camera", "bambu_ams",
+    "sim_build_mjcf", "sim_run_headless", "sim_view_live", "sim_inertia_from_stl",
+    "preview_serve", "preview_stop",
+    "bom_parse", "bom_total", "journal_append",
+    "sdf_render_stl", "sdf_list_primitives", "sdf_gyroid_infill",
+    "sdf_from_function", "sdf_lattice_infill_stl",
+    "cq_render_stl", "cq_render_step", "cq_import_step", "cq_render_svg",
+    "neural_text_to_stl", "neural_image_to_stl",
+    "pointcloud_from_stl", "pointcloud_to_stl", "pointcloud_downsample",
+]