Sand3D đến từ Sandflow và gồm hai phần. sand3d là một thư viện Python mô tả một vật thể 3D bằng một chương trình ngắn: profile, khối đặc, chỉnh sửa, khớp nối và cụm lắp ráp, do module bpy của Blender tính toán. Các bộ dữ liệu Sand3D gồm 106.094 vật thể 3D có sẵn được dựng lại thành chương trình sand3d, đăng trên Hugging Face cùng tệp 3D mà mỗi chương trình xuất ra và một ảnh render.
Ý tưởng là các mô hình ngôn ngữ có thể viết và sửa vật thể 3D như cách chúng viết code. README nói toàn bộ API nằm vừa trong một prompt khoảng 3.600 token, và các bộ phận được gọi bằng tên ("cánh cửa", "mặt trên") thay vì tọa độ tính tay.
Ai làm ra
Sandflow, một công ty làm mô hình hóa 3D xây dựng trên code. Trang của họ ghi mô hình đầu tiên là "coming soon" và có danh sách chờ. Tệp trích dẫn của thư viện nêu tác giả là Thibault Neveu và Andréa Loy. Phiên bản 1.6.3, bản phát hành công khai, ghi ngày 6 tháng 11 năm 2026, và thông cáo báo chí của Sandflow công bố bộ dữ liệu ghi ngày 5 tháng 11 năm 2026.
Khi chúng tôi kiểm tra ngày 21 tháng 11 năm 2026, kho GitHub có 2.202 sao và 241 fork, còn trang của Sandflow báo 317.082 lượt tải bộ dữ liệu trên Hugging Face.
Trong các bộ dữ liệu có gì
Năm bộ dữ liệu, theo thẻ dữ liệu trên Hugging Face:
| Bộ dữ liệu | Vật thể | Có khớp nối |
|---|---|---|
| sand3d-objaverse (đồ vật thường ngày từ Objaverse) | 66.887 | 14 |
| sand3d-cad (chi tiết cơ khí từ mô hình CAD công khai) | 24.495 | 0 |
| sand3d-articraft (vật thể có khớp) | 9.209 | 9.139 |
| sand3d-simready (tài sản NVIDIA SimReady) | 2.334 | 434 |
| sand3d-automate (cụm lắp ráp cơ khí và các chi tiết) | 3.169 | 869 |
| Tổng | 106.094 | 10.456 |
Mỗi hàng chứa chương trình sand3d của vật thể, một tệp OpenUSD (.usda) mà chương trình đã xuất (đơn vị mét, trục Z hướng lên, có vật liệu và, với vật thể có khớp, cả các khớp), một ảnh render, một danh mục sơ bộ như đồ nội thất hay dụng cụ cầm tay, và f_score đo hình dạng do chương trình dựng gần với vật thể gốc đến mức nào. Bạn có thể duyệt chúng trong trình khám phá Sand3D.
Đây là các bản dựng lại của vật thể có sẵn, và các thẻ mô tả chúng là đồ vật thường ngày, cơ cấu có khớp và chi tiết CAD cơ khí. Khớp nối được khai báo là bản lề, trượt và xoay giữa các bộ phận; không có bộ xương hay clip animation kiểu nhân vật game dùng.
Miễn phí hay trả phí, và các giấy phép
Mọi thứ đã công bố đến nay đều miễn phí.
- Thư viện theo Apache License 2.0, như kho mã nêu.
- Các bộ dữ liệu theo CC BY 4.0 (
cc-by-4.0trên từng thẻ dữ liệu). Mỗi vật thể được dẫn xuất từ một vật thể của bên thứ ba, nên giấy phép riêng của vật thể đó cũng áp dụng. Mỗi hàng có cộtsource_licensevàattribution, và các thẻ nói mọi nguồn đều theo CC-BY-4.0, Apache-2.0 hoặc CC0, không có nguồn phi thương mại hay share-alike. Với bộ Objaverse, 66.275 vật thể đến từ nguồn CC-BY-4.0 và 612 từ CC0.
Vì vậy bạn có thể dùng các vật thể trong một game thương mại, miễn là giữ phần ghi công theo từng vật thể và ghi chú rằng vật thể đã được sửa.
Cách dùng
Cài thư viện (theo README):
pip install sand3d
Blender đi kèm dưới dạng module bpy: bpy 5.2 cho Python 3.13, hoặc bpy 4.5 cho Python 3.11. Không có bpy wheel cho Python 3.12, cũng không có cho Mac Intel từ bpy 5.2 trở đi.
Chương trình đầu tiên, chép từ README. Nó dựng một giá đỡ lắp (mặc định tính bằng milimét) và xuất ra 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")
Phần mở rộng của tệp quyết định định dạng: .glb, .urdf, .usda, .ifc, .obj hoặc .stl. README mô tả GLB là định dạng "for the web, viewers, game engines", với các khớp lưu trong extras của từng node. Một tệp .glb từ sand3d nạp được vào three.js bằng GLTFLoader chuẩn, như mọi tệp glTF khác.
Để một mô hình AI viết chương trình, README bảo đặt docs/api.md vào system prompt. Với vật thể nhiều bộ phận, tài liệu có tám quy tắc viết một cụm lắp ráp. Quickstart cho thấy từng hàm kèm code và ảnh render.
Ví dụ máy giặt trong README cho thấy khớp nối trông ra sao: cửa, lồng giặt, ngăn bột giặt và núm xoay là các bộ phận có tên, và bốn dòng khai báo cách chúng chuyển động:
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")
Chúng tôi thấy gì trong một tệp
Ngày 21 tháng 11 năm 2026, chúng tôi tải tệp ví dụ mà thẻ bộ dữ liệu sand3d-articraft liên kết tới, một chiếc đèn flash máy ảnh nhỏ gọn, mà không đăng nhập Hugging Face:
- Đó là tệp OpenUSD dạng văn bản thuần 50.778 byte, đầu tệp ghi
written by sand3d: compact_flash at rest, metres and degrees, với Z là trục hướng lên. - Có 12 mesh có tên, gồm
main_body,shoe_plate, ba nút bấm,swivel_cylinder,tilt_pin,head_bodyvàflash_window, tổng cộng 364 tam giác. - Nó khai báo 5 khớp có giới hạn: ba nút trượt 3 mm (
body_to_button_0đến_2), một khớp xoay quay khoảng 90 độ mỗi bên (body_to_swivel), và một đầu đèn nghiêng từ khoảng -11 đến 90 độ (swivel_to_head). - Vật liệu là các màu có tên đơn giản (
plastic__555555,steel__444444), không có texture.
Chúng tôi không cài thư viện cho bài hướng dẫn này, nên không chạy chương trình giá đỡ. Lưu ý rằng các bộ dữ liệu cung cấp tệp .usda: để có GLB cho game three.js, bạn chạy chương trình của vật thể bằng sand3d rồi xuất ra, hoặc tự chuyển đổi tệp USD bằng công cụ của mình.
Dành cho ai
- Lập trình viên để AI agent dựng game 3D và muốn agent viết các mô hình có thể chỉnh sửa, có tên, có tham số thay vì các mesh khó đọc. Hướng dẫn Three.js cho Claude Fable 5.2 của chúng tôi yêu cầu mô hình sinh mọi mô hình bằng code; sand3d là một cách có cấu trúc để làm việc đó bằng Python.
- Nhà nghiên cứu huấn luyện hoặc thử nghiệm các mô hình viết code 3D (các bộ dữ liệu có phần tách train và validation).
- Người cần máy móc và đồ vật có khớp: cửa, ngăn kéo, cần gạt, bánh xe, nút bấm với giới hạn khớp thật.
Nếu bạn muốn một bộ tài sản game có phong cách sẵn để thả vào cảnh, thư viện tài sản game là đường ngắn hơn.
So sánh
Kenney và Quaternius phát hành các gói tài sản sẵn dùng cho game theo CC0, không cần ghi công; FAQ của Quaternius liệt kê tệp Blender và FBX. Poly Pizza là trang tìm kiếm hơn 10.700 mô hình low-poly miễn phí từ nhiều tác giả, mỗi mô hình có giấy phép riêng, thường là CC0 hoặc CC BY. Poly Haven cung cấp HDRI, texture và mô hình chân thực, tất cả theo CC0. Sand3D là một loại tài nguyên khác: các vật thể của nó là chương trình Python cùng tệp USD đã xuất, theo CC BY 4.0 với ghi công nguồn cho từng vật thể, và được làm để mô hình ngôn ngữ đọc, sửa và sinh ra. Nó không có nhân vật có rig hay clip animation, và các vật thể không được tạo phong cách thành một bộ khớp nhau như gói của Kenney hay Quaternius.
Nguồn
- Thư viện: github.com/Sandflow-ai/sand3d, gồm LICENSE và API cho LLM
- Tài liệu: sand3d.sandflow.ai, quickstart, hướng dẫn lắp ráp
- Sandflow: sandflow.ai/sand3d
- Bộ dữ liệu: bộ sưu tập Sand3D trên Hugging Face và trình khám phá
Số sao, fork và lượt tải được kiểm tra ngày 21 tháng 11 năm 2026.
Đã làm game với mô hình tạo bằng code? Gửi nó lên VibeGamer.



