项目说明
sand3d 是什么
sand3d 是一个 Python 库,用「短程序」的方式描述 3D 物体:轮廓(profiles)、实体(solids)、编辑(edits)、坐标框架(frames)、关节(joints)和装配体(assemblies),底层跑在 Blender 的 bpy 之上。
它和传统建模脚本的关键差别是「说清怎么造」而不是「算出一堆顶点」。一个程序按零件逐段描述形状,所以模型用几百个 token 就能写完,人类也能读懂。
| 对比项 | sand3d | Blender Python | CadQuery / FeatureScript |
|---|---|---|---|
| 同等零件的 token 用量 | 少 2–6 倍 | 基线 | 基线 |
| 整个 API 能否塞进 prompt | 能,约 3,600 token | 不能 | 不能 |
| 表达方式 | 命名式(named, not computed) | 计算式 | 计算式 |
| 导出格式 | GLB、URDF、USD、IFC、OBJ、STL | 需插件 | 有限 |
导出格式覆盖 GLB、URDF、USD、IFC、OBJ、STL,既能进渲染管线,也能直接给机器人仿真用。官方另外提供数据集和 Explorer 供参考。
sand3d 怎么安装
pip install sand3d
在 uv 项目里:
uv add sand3d
sand3d 怎么使用
- 先写一个最小零件跑通,确认 bpy 环境正常。
- 按「轮廓 → 实体 → 编辑」的顺序描述形状,别一上来就写复杂装配体。
- 多个零件用 frames 定位、joints 连接,最后组装成 assemblies。
- 要交给 LLM 写,把那份 3,600 token 的 API 说明整段放进 prompt,让它照格式写。
- 导出按用途选:渲染用 GLB/OBJ,机器人仿真用 URDF,工程交换用 IFC/STEP 系格式。
sand3d 适合谁用
- 想让大模型直接产出 3D 模型的开发者——它为 LLM 省 token 是设计目标。
- 做参数化零件、装配体,希望代码可读可改的工程师。
- 需要从模型直接导出 URDF 做机器人仿真的团队。
- 已经在用 Blender、想用编程替代手工建模的人。
- 要做影视级手工雕刻、复杂曲面造型的场景,代码建模不是好选择。
sand3d 项目地址
- GitHub 仓库:https://github.com/Sandflow-ai/sand3d
- 项目官网:https://sand3d.ai
- API 说明:https://github.com/Sandflow-ai/sand3d/blob/main/docs/api.md