Repolode
Sandflow-ai

Sandflow-ai/sand3d

Python-библиотека для описания 3D-объектов короткими программами с именованными частями на базе Blender bpy, рассчитанная на генерацию кода с помощью LLM.

Звёзды
724
Форки
83
Открытые issues
2
Последний коммит
вчера

Что это?

sand3d позволяет описывать 3D-объект короткой программой на Python, составленной из профилей, тел, операций, систем координат, шарниров и сборок и выполняемой с помощью модуля Blender bpy. Части, рёбра и грани задаются по именам, а не вычисляемым вручную координатам, и одна и та же программа всегда создаёт одинаковую сетку.

Библиотека экспортирует модели в GLB, URDF, USDA, OBJ и STL одним вызовом; варианты USD создаются средствами самого USD. В экспортируемых форматах сохраняются шарниры с ограничениями (hinge, slide, continuous), поэтому модели с подвижными частями, например стиральную машину с открывающейся дверцей и выдвижным ящиком, можно сразу описать и экспортировать.

В документации проекта есть компактный справочник API объёмом около 3 600 токенов, предназначенный для системного промпта LLM, а также рекомендации по созданию сборок из нескольких частей. На Hugging Face опубликовано несколько открытых наборов данных с программами sand3d, созданными на основе таких источников, как Objaverse, CAD-модели и NVIDIA SimReady; лицензия — CC BY 4.0.

Ключевые возможности

  • 01Создаёт объекты из именованных профилей, тел, операций и систем координат, а не из исходных координат.
  • 02Задаёт для подвижных объектов шарниры с типом, осью и диапазоном движения.
  • 03Экспортирует модели в GLB, URDF, USDA, OBJ и STL одним вызовом.
  • 04Включает компактный справочник API, рассчитанный на системные промпты LLM.
  • 05Создаёт одинаковые сетки при запуске одной и той же программы.

Сценарии использования

  • Поручить LLM генерировать параметрические 3D-детали по коротким текстовым программам.
  • Создавать подвижные объекты с шарнирами для робототехники или экспорта в форматы симуляции физики, например URDF.
  • Экспортировать модели, созданные процедурно, в GLB или USD для просмотра и конвейеров Omniverse.
  • Создавать наборы данных с понятными 3D-программами для обучения моделей или оценки их работы.

Быстрый старт

  1. 1

    Установите sand3d с помощью pip (требуется Python 3.13 или 3.11).

    pip install sand3d
  2. 2

    Напишите программу с использованием API sand3d, а затем экспортируйте её в GLB, URDF, USDA, OBJ или STL с помощью s3d.export.

Что важно знать

  • Для Python 3.12 нет wheel-пакета bpy, а начиная с bpy 5.2 wheel-пакетов нет и для компьютеров Mac с процессором Intel, поэтому в этих конфигурациях нужно использовать Python 3.11.
  • Blender входит в установку в виде модуля bpy, из-за чего зависимость получается тяжёлой.

В подборках

Темы

Частые вопросы

Что такое sand3d?
Python-библиотека для описания 3D-объектов короткими программами с именованными частями на базе Blender bpy, рассчитанная на генерацию кода с помощью LLM. sand3d позволяет описывать 3D-объект короткой программой на Python, составленной из профилей, тел, операций, систем координат, шарниров и сборок и выполняемой с помощью модуля Blender bpy. Части, рёбра и грани задаются по именам, а не вычисляемым вручную координатам, и одна и та же программа всегда создаёт одинаковую сетку.
sand3d можно использовать бесплатно? Какая у него лицензия?
sand3d распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
sand3d всё ещё поддерживается?
Активно поддерживается. Последний коммит в sand3d — 6 нояб. 2026 г..
Для чего можно использовать sand3d?
Поручить LLM генерировать параметрические 3D-детали по коротким текстовым программам. Создавать подвижные объекты с шарнирами для робототехники или экспорта в форматы симуляции физики, например URDF. Экспортировать модели, созданные процедурно, в GLB или USD для просмотра и конвейеров Omniverse. Создавать наборы данных с понятными 3D-программами для обучения моделей или оценки их работы.
Как установить sand3d?
Установите sand3d с помощью pip (требуется Python 3.13 или 3.11).: pip install sand3d Напишите программу с использованием API sand3d, а затем экспортируйте её в GLB, URDF, USDA, OBJ или STL с помощью s3d.export.
Где скачать sand3d?
Исходный код и инструкции по установке — на GitHub: https://github.com/Sandflow-ai/sand3d

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Локальное настольное CAD-приложение с совместимой со Studio средой моделирования и помощником на базе Pydantic AI; сборка CAD-моделей выполняется на вашем компьютере.

84+9 за неделю8TypeScriptApache-2.0Активно поддерживаетсяОбновлён позавчера

Кроссплатформенная система параметрического 3D-моделирования объектов любого размера с открытым исходным кодом, построенная на OpenCASCADE.

35,2 тыс.+121 за неделю6,4 тыс.C++LGPL-2.1Активно поддерживаетсяОбновлён 22 часа назад

Плагин DSH позволяет AI-модели управлять запущенным Blender по прямому TCP-каналу и предоставляет 16 инструментов для захвата вида, редактирования сцены и работы в headless-режиме.

1,7 тыс.+182 за неделю65PythonBSD-3-ClauseАктивно поддерживаетсяОбновлён вчера