Sand3D pochodzi od Sandflow i ma dwie części. sand3d to biblioteka Pythona, która opisuje obiekt 3D jako krótki program: profile, bryły, edycje, przeguby i zespoły, liczone przez moduł bpy Blendera. Zbiory danych Sand3D to 106 094 istniejące obiekty 3D odtworzone jako programy sand3d i opublikowane na Hugging Face razem z plikiem 3D, który każdy program eksportuje, i jego renderem.
Pomysł jest taki, że modele językowe mogą pisać i edytować obiekty 3D tak, jak piszą kod. README mówi, że całe API mieści się w prompcie o długości około 3600 tokenów, a części wskazuje się po nazwie („the door”, „the top face”), a nie przez ręcznie liczone współrzędne.
Kto go stworzył
Sandflow, firma pracująca nad modelowaniem 3D opartym na kodzie. Na jej stronie pierwszy model figuruje jako „coming soon” z listą oczekujących. Plik cytowania biblioteki wymienia jako autorów Thibaulta Neveu i Andréę Loy. Wersja 1.6.3, czyli publiczne wydanie, nosi datę 6 listopada 2026, a komunikat prasowy Sandflow o zbiorze danych jest z 5 listopada 2026.
Gdy sprawdzaliśmy 21 listopada 2026, repozytorium na GitHubie miało 2202 gwiazdki i 241 forków, a strona Sandflow podawała 317 082 pobrania zbiorów danych na Hugging Face.
Co jest w zbiorach danych
Pięć zbiorów, według kart zbiorów na Hugging Face:
| Zbiór danych | Obiekty | Z przegubami |
|---|---|---|
| sand3d-objaverse (przedmioty codziennego użytku z Objaverse) | 66 887 | 14 |
| sand3d-cad (części mechaniczne z publicznych modeli CAD) | 24 495 | 0 |
| sand3d-articraft (obiekty z ruchomymi częściami) | 9209 | 9139 |
| sand3d-simready (zasoby NVIDIA SimReady) | 2334 | 434 |
| sand3d-automate (zespoły mechaniczne i ich części) | 3169 | 869 |
| Razem | 106 094 | 10 456 |
Każdy wiersz zawiera program sand3d obiektu, plik OpenUSD (.usda) wyeksportowany przez program (metry, oś Z w górę, z materiałami, a dla obiektów z ruchomymi częściami także z przegubami), render, zgrubną kategorię, na przykład meble albo narzędzie ręczne, oraz f_score, który mierzy, jak blisko oryginalnego obiektu jest kształt z programu. Możesz je przeglądać w eksploratorze Sand3D.
To odtworzone wersje istniejących obiektów, a karty opisują je jako przedmioty codziennego użytku, mechanizmy z ruchomymi częściami i mechaniczne części CAD. Przeguby są zadeklarowane jako zawiasy, suwaki i obroty między częściami; nie ma szkieletów ani klipów animacji takich jak w postaciach z gier.
Darmowe czy płatne i licencje
Wszystko, co dotąd opublikowano, jest darmowe.
- Biblioteka jest na Apache License 2.0, jak podaje repozytorium.
- Zbiory danych są na CC BY 4.0 (
cc-by-4.0na każdej karcie zbioru). Każdy obiekt pochodzi od cudzego obiektu, więc obowiązuje też jego własna licencja. Każdy wiersz ma kolumnysource_licenseiattribution, a karty mówią, że każde źródło jest na CC-BY-4.0, Apache-2.0 albo CC0, żadne niekomercyjne ani share-alike. W zbiorze Objaverse 66 275 obiektów pochodzi ze źródeł CC-BY-4.0, a 612 z CC0.
Możesz więc używać obiektów w grze komercyjnej, o ile zachowasz informację o autorstwie każdego obiektu i adnotację, że obiekt zmodyfikowano.
Jak go używać
Zainstaluj bibliotekę (z README):
pip install sand3d
Blender przychodzi razem z nią jako moduł bpy: bpy 5.2 na Pythonie 3.13 albo bpy 4.5 na Pythonie 3.11. Nie ma paczki bpy dla Pythona 3.12 ani, od bpy 5.2, dla Maców z Intelem.
Pierwszy program, skopiowany z README. Buduje wspornik montażowy, domyślnie w milimetrach, i eksportuje go jako 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")
Format wybiera rozszerzenie pliku: .glb, .urdf, .usda, .ifc, .obj lub .stl. README opisuje GLB jako format „for the web, viewers, game engines”, z przegubami zapisanymi w extras każdego węzła. Plik .glb z sand3d wczytuje się w three.js standardowym GLTFLoader, jak każdy inny plik glTF.
Żeby model AI pisał programy, README każe umieścić docs/api.md w prompcie systemowym. Dla obiektów z wieloma częściami dokumentacja ma osiem zasad pisania zespołu. Quickstart pokazuje każdą funkcję z kodem i renderem.
Przykład pralki z README pokazuje, jak wyglądają przeguby: drzwi, bęben, szuflada na proszek i pokrętło to części z nazwami, a cztery linie deklarują, jak się poruszają:
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")
Co znaleźliśmy w jednym pliku
21 listopada 2026 pobraliśmy przykładowy plik, do którego odsyła karta zbioru sand3d-articraft, czyli kompaktową lampę błyskową, bez logowania do Hugging Face:
- To plik OpenUSD w czystym tekście, 50 778 bajtów, z nagłówkiem
written by sand3d: compact_flash at rest, metres and degreesi osią Z w górę. - Ma 12 nazwanych siatek, między innymi
main_body,shoe_plate, trzy przyciski,swivel_cylinder,tilt_pin,head_bodyiflash_window, razem 364 trójkąty. - Deklaruje 5 przegubów z limitami: trzy przyciski wsuwane o 3 mm (
body_to_button_0do_2), obrotowy cylinder, który obraca się o około 90 stopni w każdą stronę (body_to_swivel), i głowicę, która przechyla się od około -11 do 90 stopni (swivel_to_head). - Materiały to proste nazwane kolory (
plastic__555555,steel__444444), bez tekstur.
Nie instalowaliśmy biblioteki na potrzeby tego poradnika, więc nie uruchamialiśmy programu wspornika. Zwróć uwagę, że zbiory zawierają pliki .usda: żeby dostać GLB do gry w three.js, uruchamiasz program obiektu w sand3d i eksportujesz go albo konwertujesz plik USD własnymi narzędziami.
Dla kogo
- Dla programistów, którzy pozwalają agentowi AI budować gry 3D i chcą, żeby agent pisał edytowalne, nazwane, parametryczne modele zamiast nieprzejrzystych siatek. Nasz poradnik Three.js dla Claude Fable 5.2 każe modelowi generować wszystkie modele w kodzie; sand3d to jeden ze strukturalnych sposobów na to w Pythonie.
- Dla badaczy, którzy trenują lub testują modele piszące kod 3D (zbiory mają podziały na train i validation).
- Dla osób, które potrzebują maszyn i rekwizytów z ruchomymi częściami: drzwi, szuflad, dźwigni, kół, przycisków z prawdziwymi limitami przegubów.
Jeśli chcesz gotowy, stylizowany zestaw zasobów do gry, który wrzucisz do sceny, krótszą drogą jest biblioteka zasobów do gier.
Porównanie
Kenney i Quaternius publikują gotowe do gry paczki zasobów na CC0, bez potrzeby podawania autorstwa; FAQ Quaternius wymienia pliki Blendera i FBX. Poly Pizza to wyszukiwarka ponad 10 700 darmowych modeli low-poly od wielu autorów, każdy z własną licencją, zwykle CC0 lub CC BY. Poly Haven oferuje realistyczne HDRI, tekstury i modele, wszystko na CC0. Sand3D to zasób innego rodzaju: jego obiekty to programy w Pythonie plus wyeksportowane pliki USD, na licencji CC BY 4.0 z atrybucją źródła dla każdego obiektu, zrobione po to, żeby modele językowe mogły je czytać, edytować i generować. Nie ma w nim postaci ze szkieletem ani klipów animacji, a jego obiekty nie są stylizowane na spójny zestaw jak paczki Kenneya czy Quaternius.
Źródła
- Biblioteka: github.com/Sandflow-ai/sand3d, w tym LICENSE i API dla LLM
- Dokumentacja: sand3d.sandflow.ai, quickstart, zasady dla zespołów
- Sandflow: sandflow.ai/sand3d
- Zbiory danych: kolekcja Sand3D na Hugging Face i eksplorator
Liczby gwiazdek, forków i pobrań sprawdziliśmy 21 listopada 2026.
Zrobiłeś grę z modelami zbudowanymi w kodzie? Zgłoś ją do VibeGamer.



