Sand3D 来自 Sandflow,分两部分。sand3d 是一个 Python 库,用一段简短的程序来描述 3D 物体:轮廓、实体、编辑、关节和装配体,由 Blender 的 bpy 模块计算。Sand3D 数据集是 106,094 个现有 3D 物体,被重建成 sand3d 程序,发布在 Hugging Face 上,附带每个程序导出的 3D 文件和一张渲染图。
它的想法是让语言模型像写代码一样写和编辑 3D 物体。README 说整个 API 可以放进约 3,600 个 token 的提示词里,而且零件用名字来指代("门""顶面"),不用手算坐标。
谁做的
Sandflow,一家做代码驱动 3D 建模的公司。它的网站把第一个模型列为"coming soon",并提供候补名单。库的引用文件署名作者是 Thibault Neveu 和 Andréa Loy。公开发布的 1.6.3 版日期是 2026 年 11 月 6 日,Sandflow 宣布数据集的新闻稿日期是 2026 年 11 月 5 日。
我们在 2026 年 11 月 21 日查看时,GitHub 仓库有 2,202 个星标、241 个 fork,Sandflow 的页面显示数据集在 Hugging Face 上的下载量为 317,082 次。
数据集里有什么
五个数据集,来自 Hugging Face 上的数据集卡片:
| 数据集 | 物体数 | 带关节 |
|---|---|---|
| sand3d-objaverse(来自 Objaverse 的日常物品) | 66,887 | 14 |
| sand3d-cad(来自公开 CAD 模型的机械零件) | 24,495 | 0 |
| sand3d-articraft(可活动的物体) | 9,209 | 9,139 |
| sand3d-simready(NVIDIA SimReady 素材) | 2,334 | 434 |
| sand3d-automate(机械装配体及其零件) | 3,169 | 869 |
| 合计 | 106,094 | 10,456 |
每一行包含物体的 sand3d 程序、程序导出的 OpenUSD(.usda)文件(单位为米,Z 轴向上,带材质,可活动的物体还带关节)、一张渲染图、一个粗略的类别(如家具、手工工具),以及一个 f_score,用来衡量程序生成的形状与原物体的接近程度。你可以在 Sand3D explorer 里浏览。
这些是现有物体的重建版本,卡片把它们描述为日常物品、可活动的机构和机械 CAD 零件。关节被声明为零件之间的铰链、滑动和旋转;没有游戏角色用的那种骨骼或动画片段。
免费还是收费,以及许可证
目前发布的所有内容都是免费的。
- 库使用 Apache License 2.0,仓库里有明确说明。
- 数据集使用 CC BY 4.0(每张数据集卡片上写的是
cc-by-4.0)。每个物体都源自第三方物体,所以那个物体自己的许可证同样适用。每一行都有source_license和attribution列,卡片说所有来源都是 CC-BY-4.0、Apache-2.0 或 CC0,没有非商业或相同方式共享的。在 Objaverse 数据集中,66,275 个物体来自 CC-BY-4.0 来源,612 个来自 CC0。
所以你可以在商业游戏里使用这些物体,前提是保留每个物体的署名,以及"该物体经过修改"的说明。
怎么用
安装库(来自 README):
pip install sand3d
Blender 以 bpy 模块的形式一并安装:Python 3.13 上是 bpy 5.2,Python 3.11 上是 bpy 4.5。Python 3.12 没有 bpy 的 wheel,从 bpy 5.2 起 Intel Mac 也没有。
第一个程序,抄自 README。它构建一个安装支架,默认单位是毫米,并导出为 GLB:
import sand3d as s3d
def bracket(w=80, d=40, t=6, hole_d=6.6, pitch=50):
plate = s3d.extrude("plate", s3d.rect(w, d, r=4), t)
s3d.hole(plate, hole_d, on=s3d.grid(2, 1, pitch, 0))
s3d.fillet(plate, 1, edges="top")
return plate
s3d.export(bracket(), "bracket.glb")
文件扩展名决定格式:.glb、.urdf、.usda、.ifc、.obj 或 .stl。README 把 GLB 描述为"for the web, viewers, game engines"的格式,关节存放在每个节点的 extras 里。sand3d 导出的 .glb 可以用标准的 GLTFLoader 在 three.js 里加载,和其他 glTF 文件一样。
想让 AI 模型来写程序,README 说要把 docs/api.md 放进系统提示词。对于有多个零件的物体,文档里有编写装配体的八条规则。快速入门用代码和渲染图展示了每个函数。
README 里的洗衣机例子展示了关节的样子:门、滚筒、洗涤剂抽屉和旋钮都是有名字的零件,四行代码声明了它们怎么运动:
s3d.joint("door_hinge", door, hinge, axis="-Z", range=(0, 143))
s3d.joint("drum_spin", drum, front.move(0, 400), kind="continuous")
s3d.joint("drawer_slide", drawer, top_band.move(150), kind="prismatic", axis="+X", range=(0, 200))
s3d.joint("dial_turn", dial, top_band.move(-150), kind="continuous")
我们在一个文件里发现了什么
2026 年 11 月 21 日,我们下载了 sand3d-articraft 数据集卡片所链接的示例文件,一个小巧的相机闪光灯,没有登录 Hugging Face:
- 这是一个纯文本的 OpenUSD 文件,50,778 字节,文件头写着
written by sand3d: compact_flash at rest, metres and degrees,Z 为向上轴。 - 它有 12 个命名的网格,包括
main_body、shoe_plate、三个按钮、swivel_cylinder、tilt_pin、head_body和flash_window,合计 364 个三角形。 - 它声明了 5 个带限位的关节:三个可滑动 3 毫米的按钮(
body_to_button_0到_2),一个向两侧各转约 90 度的旋转座(body_to_swivel),以及一个从约 -11 度倾斜到 90 度的灯头(swivel_to_head)。 - 材质是简单的命名颜色(
plastic__555555、steel__444444),没有贴图。
我们没有为这篇指南安装这个库,所以没有运行支架程序。注意,数据集提供的是 .usda 文件:要得到可用于 three.js 游戏的 GLB,你需要用 sand3d 运行该物体的程序并导出,或者用自己的工具转换 USD 文件。
适合谁
- 让 AI 智能体构建 3D 游戏的开发者,希望智能体写出可编辑、有名字、参数化的模型,而不是黑盒网格。我们的 Claude Fable 5.2 Three.js 指南要求模型用代码生成所有模型;sand3d 是用 Python 做这件事的一种结构化方式。
- 训练或测试写 3D 代码的模型的研究人员(数据集有训练集和验证集划分)。
- 需要机器和可活动道具的人:门、抽屉、拉杆、轮子、带真实关节限位的按钮。
如果你想要现成的、风格统一的游戏素材直接放进场景,游戏素材库是更短的路。
和其他资源比较
Kenney 和 Quaternius 以 CC0 发布可直接用于游戏的素材包,不需要署名;Quaternius 的 FAQ 列出了 Blender 和 FBX 文件。Poly Pizza 是一个搜索站,收录 10,700 多个来自许多作者的免费低多边形模型,每个模型有自己的许可证,通常是 CC0 或 CC BY。Poly Haven 提供写实的 HDRI、贴图和模型,全部是 CC0。Sand3D 是另一类资源:它的物体是 Python 程序加导出的 USD 文件,以 CC BY 4.0 授权并附每个物体的来源署名,为语言模型阅读、编辑和生成而做。它没有带骨骼的角色和动画片段,物体也不像 Kenney 或 Quaternius 的素材包那样被做成风格统一的一套。
来源
- 库:github.com/Sandflow-ai/sand3d,包括它的 LICENSE 和给大语言模型用的 API
- 文档:sand3d.sandflow.ai、快速入门、装配体规范
- Sandflow:sandflow.ai/sand3d
- 数据集:Hugging Face 上的 Sand3D 合集和 explorer
星标、fork 和下载数均于 2026 年 11 月 21 日核对。
做过用代码生成模型的游戏?提交到 VibeGamer。



