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.0 na każdej karcie zbioru). Każdy obiekt pochodzi od cudzego obiektu, więc obowiązuje też jego własna licencja. Każdy wiersz ma kolumny source_license i attribution, 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 degrees i osią Z w górę.
  • Ma 12 nazwanych siatek, między innymi main_body, shoe_plate, trzy przyciski, swivel_cylinder, tilt_pin, head_body i flash_window, razem 364 trójkąty.
  • Deklaruje 5 przegubów z limitami: trzy przyciski wsuwane o 3 mm (body_to_button_0 do _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

Liczby gwiazdek, forków i pobrań sprawdziliśmy 21 listopada 2026.

Zrobiłeś grę z modelami zbudowanymi w kodzie? Zgłoś ją do VibeGamer.