Sand3D comes from Sandflow and has two parts. sand3d is a Python library for describing a 3D object as a short program: profiles, solids, edits, joints and assemblies, computed by Blender's bpy module. The Sand3D datasets are 106,094 existing 3D objects rebuilt as sand3d programs, published on Hugging Face with the 3D file each program exports and a render of it.
The idea is that language models can write and edit 3D objects the way they write code. The README says the whole API fits in a prompt of about 3,600 tokens, and that parts are referred to by name ("the door", "the top face") instead of by hand-computed coordinates.
Who made it
Sandflow, a company working on 3D modelling built on code. Its site lists a first model as "coming soon" with a waitlist. The library's citation file names Thibault Neveu and Andréa Loy as authors. Version 1.6.3, the public release, is dated 6 November 2026, and Sandflow's press release announcing the dataset is dated 5 November 2026.
When we checked on 21 November 2026, the GitHub repository had 2,202 stars and 241 forks, and Sandflow's page reported 317,082 dataset downloads on Hugging Face.
What is in the datasets
Five datasets, from the dataset cards on Hugging Face:
| Dataset | Objects | With joints |
|---|---|---|
| sand3d-objaverse (everyday objects from Objaverse) | 66,887 | 14 |
| sand3d-cad (mechanical parts from public CAD models) | 24,495 | 0 |
| sand3d-articraft (articulated objects) | 9,209 | 9,139 |
| sand3d-simready (NVIDIA SimReady assets) | 2,334 | 434 |
| sand3d-automate (mechanical assemblies and their parts) | 3,169 | 869 |
| Total | 106,094 | 10,456 |
Each row holds the object's sand3d program, an OpenUSD (.usda) file the program exported (metres, Z up, with materials and, for articulated objects, joints), a render, a rough category such as furniture or hand tool, and an f_score that measures how close the program's shape is to the original object. You can browse them in the Sand3D explorer.
These are rebuilt versions of existing objects, and the cards describe them as everyday objects, articulated mechanisms and mechanical CAD parts. Joints are declared as hinges, slides and spins between parts; there are no skeletons or animation clips of the kind a game character uses.
Free or paid, and the licences
Everything published so far is free.
- The library is under the Apache License 2.0, as the repository states.
- The datasets are under CC BY 4.0 (
cc-by-4.0on each dataset card). Each object is derived from a third-party object, so that object's own licence also applies. Every row hassource_licenseandattributioncolumns, and the cards say every source is under CC-BY-4.0, Apache-2.0 or CC0, none non-commercial or share-alike. For the Objaverse set, 66,275 objects come from CC-BY-4.0 sources and 612 from CC0.
So you can use the objects in a commercial game, as long as you keep the per-object attribution and the note that the object was modified.
How to use it
Install the library (from the README):
pip install sand3d
Blender comes with it as the bpy module: bpy 5.2 on Python 3.13, or bpy 4.5 on Python 3.11. There is no bpy wheel for Python 3.12, nor for Intel Macs from bpy 5.2 on.
A first program, copied from the README. It builds a mounting bracket, in millimetres by default, and exports it as 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")
The file extension picks the format: .glb, .urdf, .usda, .ifc, .obj or .stl. The README describes GLB as the format "for the web, viewers, game engines", with joints stored in each node's extras. A .glb from sand3d loads in three.js with the standard GLTFLoader, like any other glTF file.
To have an AI model write programs, the README says to put docs/api.md in the system prompt. For objects with several parts, the docs have eight rules for writing an assembly. The quickstart shows every function with code and a render.
The README's washing machine example shows what joints look like: the door, drum, detergent drawer and dial are named parts, and four lines declare how they move:
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")
What we found in one file
On 21 November 2026 we downloaded the example file the sand3d-articraft dataset card links to, a compact camera flash, without signing in to Hugging Face:
- It is a plain-text OpenUSD file of 50,778 bytes, headed
written by sand3d: compact_flash at rest, metres and degrees, with Z as the up axis. - It has 12 named meshes, including
main_body,shoe_plate, three buttons,swivel_cylinder,tilt_pin,head_bodyandflash_window, for 364 triangles in total. - It declares 5 joints with limits: three buttons that slide 3 mm (
body_to_button_0to_2), a swivel that turns about 90 degrees each way (body_to_swivel), and a head that tilts from about -11 to 90 degrees (swivel_to_head). - Materials are simple named colours (
plastic__555555,steel__444444) with no textures.
We did not install the library for this guide, so we didn't run the bracket program. Note that the datasets ship .usda files: to get a GLB for a three.js game you run the object's program with sand3d and export it, or convert the USD file with your own tools.
Who it's for
- Developers who let an AI agent build 3D games and want the agent to write editable, named, parametric models instead of opaque meshes. Our Three.js guide for Claude Fable 5.2 asks the model to generate all models in code; sand3d is one structured way to do that, in Python.
- Researchers training or testing models that write 3D code (the datasets have train and validation splits).
- People who need machines and articulated props: doors, drawers, levers, wheels, buttons with real joint limits.
If you want a ready-made, stylised set of game assets to drop into a scene, a game asset library is the shorter path.
How it compares
Kenney and Quaternius publish game-ready asset packs under CC0, with no credit needed; Quaternius' FAQ lists Blender and FBX files. Poly Pizza is a search site for more than 10,700 free low-poly models from many authors, each with its own licence, usually CC0 or CC BY. Poly Haven offers realistic HDRIs, textures and models, all CC0. Sand3D is a different kind of resource: its objects are Python programs plus exported USD files, licensed CC BY 4.0 with per-object source attribution, and built for being read, edited and generated by language models. It has no rigged characters or animation clips, and its objects are not styled as a matching set the way Kenney's or Quaternius' packs are.
Sources
- Library: github.com/Sandflow-ai/sand3d, including its LICENSE and API for LLMs
- Documentation: sand3d.sandflow.ai, quickstart, assembly guidelines
- Sandflow: sandflow.ai/sand3d
- Datasets: the Sand3D collection on Hugging Face and the explorer
Star, fork and download counts were checked on 21 November 2026.
Built a game with code-made models? Submit it to VibeGamer.



