Sandflow-ai GitHub avatar

sand3d

HTML
LLM 三维建模工具Sandflow-ai最近推送 2026年11月18日
多模态生成Apache-2.02,15823618 issues7 天 +302

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

用 Python 写 3D 模型的库,专为大模型生成代码设计。

sand3d 是一个基于 Blender bpy 的 Python 库,把 3D 物体写成短程序:轮廓、实体、编辑、坐标系、关节和装配。程序描述形状如何一步步做出来,代码短、可读,适合 LLM 生成。

推荐指数

4.0

面向 LLM 的 3D 建模 DSL,代码短、可读、可导出多种格式,适合程序化建模和 AI 生成场景。

近 7 天

+302

新增 Star

总 Star 排名

#2184

雷达追踪的 3,958 个 AI 仓库中

创建于

2026

2026年11月3日

核心亮点

  • 1代码极短

    同一零件比 Blender Python、CadQuery 等少 2 到 6 倍 token。

  • 2API 精简

    完整 API 约 3600 token,可整体放进提示词。

  • 3按名操作

    零件、边、面通过名字访问,不用手算坐标。

  • 4结果确定

    同一程序每次生成相同网格,逐位一致。

  • 5多格式导出

    一次调用导出 GLB、URDF、USD、IFC、OBJ、STL。

适用场景

  • LLM 生成 3D 模型代码

    例如:让大模型用 sand3d 写一个带铰链门的洗衣机装配程序。

  • 程序化参数建模

    例如:用函数定义支架尺寸,改参数重新生成模型并导出 GLB。

  • 机器人仿真模型准备

    例如:导出 URDF 和 OBJ,用于 ROS、PyBullet 或 MuJoCo。

  • BIM 与 USD 流程

    例如:导出 IFC 给 Revit,或导出 USDA 给 Omniverse。

它是怎么工作的

  1. 第 1 步

    定义零件

    用 extrude、rect 等函数创建带名字的实体。

  2. 第 2 步

    编辑形状

    用 hole、fillet 等操作按名字修改边和面。

  3. 第 3 步

    组装与关节

    用 group 分组,用 joint 定义运动方式和范围。

  4. 第 4 步

    导出文件

    调用 export,按扩展名选择 GLB、URDF、USD、IFC 等格式。

快速上手

  1. 1

    安装

    需要 Python 3.13 或 3.11,bpy 随包安装。

    pip install sand3d
  2. 2

    写第一个模型

    用 extrude 创建板,加孔和圆角。

  3. 3

    导出

    调用 export 输出 GLB 文件。

    s3d.export(bracket(), "bracket.glb")

适合谁

  • 用 LLM 生成 3D 代码的开发者
  • 需要程序化参数建模的工程师
  • 做机器人仿真模型准备的人
  • 熟悉 Python 的 3D 内容创作者

不太适合

  • 需要交互式建模界面的用户
  • 不熟悉 Python 的初学者

成熟度

  • 活跃度创建不到一个月,已有 2098 star,最近两周内有推送。
  • 文档README 含安装、示例、导出格式说明,另有文档站和 API 页。
  • 社区232 fork、14 个开放 issue,项目很新,社区还在形成。
  • 上手难度pip 安装,API 精简,示例代码短,但需了解 Python 和基本 3D 概念。

同类项目怎么选

  • CadQuery基于 OpenCASCADE 的 Python CAD 库,偏工程 CAD,sand3d 更面向 LLM 且代码更短。
  • Blender Python (bpy)直接操作 Blender 场景,sand3d 在其上提供更高层、更简洁的建模接口。

使用前注意

  • · 依赖 bpy,Python 3.12 和部分 Intel Mac 需改用 Python 3.11。
  • · IFC 导出不含关节,GlobalId 可能随几何变化,不宜跨导出追踪零件。
  • · 项目创建时间很短,API 可能还不稳定。
  • · Apache-2.0 许可,商用需遵守许可条款。

主题标签

3dblendercadllmprocedural-modelingpythonusd