Sand3D는 Sandflow에서 나왔고 두 부분으로 되어 있습니다. sand3d는 3D 오브젝트를 짧은 프로그램으로 기술하는 Python 라이브러리입니다. 프로파일, 솔리드, 편집, 조인트, 어셈블리를 Blender의 bpy 모듈이 계산합니다. Sand3D 데이터셋은 기존 3D 오브젝트 106,094개를 sand3d 프로그램으로 다시 만든 것으로, 각 프로그램이 내보내는 3D 파일과 렌더 이미지와 함께 Hugging Face에 공개되어 있습니다.
발상은 언어 모델이 코드를 쓰듯 3D 오브젝트를 쓰고 고치게 하자는 것입니다. README에 따르면 API 전체가 약 3,600토큰짜리 프롬프트에 들어가고, 부품은 손으로 계산한 좌표 대신 이름("문", "윗면")으로 가리킵니다.
만든 곳
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개였고, 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). 각 오브젝트는 제3자의 오브젝트에서 파생되었으므로 그 오브젝트의 라이선스도 함께 적용됩니다. 모든 행에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 휠은 없고, 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는 다른 glTF 파일과 마찬가지로 three.js의 표준 GLTFLoader로 불러올 수 있습니다.
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개가 선언되어 있습니다. 3mm 슬라이드하는 버튼 세 개(
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와 LLM용 API 포함
- 문서: sand3d.sandflow.ai, 퀵스타트, 어셈블리 가이드라인
- Sandflow: sandflow.ai/sand3d
- 데이터셋: Hugging Face의 Sand3D 컬렉션과 explorer
별, 포크, 다운로드 수는 2026년 11월 21일에 확인했습니다.
코드로 만든 모델로 게임을 만드셨나요? VibeGamer에 제출해 보세요.



