AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日
用 Python 写 3D 模型的库,专为大模型生成代码设计。
sand3d 是一个基于 Blender bpy 的 Python 库,把 3D 物体写成短程序:轮廓、实体、编辑、坐标系、关节和装配。程序描述形状如何一步步做出来,代码短、可读,适合 LLM 生成。
推荐指数
面向 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 步
定义零件
用 extrude、rect 等函数创建带名字的实体。
第 2 步
编辑形状
用 hole、fillet 等操作按名字修改边和面。
第 3 步
组装与关节
用 group 分组,用 joint 定义运动方式和范围。
第 4 步
导出文件
调用 export,按扩展名选择 GLB、URDF、USD、IFC 等格式。
快速上手
- 1
安装
需要 Python 3.13 或 3.11,bpy 随包安装。
pip install sand3d - 2
写第一个模型
用 extrude 创建板,加孔和圆角。
- 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 许可,商用需遵守许可条款。
