ldraw-nova — воркфлоу
ldraw-nova дает ИИ-агенту инструменты, чтобы собрать по описанию модель LEGO в формате LDraw с проверкой столкновений
- 543 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Запускает Docker-контейнеры и генерирует и исполняет Python-скрипты, написанные агентом
- Веб-приложение не требует входа и доступно с других устройств сети по IP компьютера
Установка
- Работает в
Ручная установка
git clone --branch v0.6.0 https://github.com/anteloc/ldraw-nova.gitРядом клонируйте ldraw-nova-docker того же тега, затем в его папке выполните docker compose build.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает Docker-контейнеры и генерирует и исполняет Python-скрипты, написанные агентом
- Веб-приложение не требует входа и доступно с других устройств сети по IP компьютера
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ldraw-nova — набор инструментов, примеров и инструкций, с которым агент проектирует модели из настоящих деталей LEGO в формате LDraw. Агент получает описание, читает `instructions.md` и связанные документы, планирует модель с подмоделями и затем по кругу рендерит изображения, осматривает их и поправляет положение и внешний вид. Детали напрямую агент почти не расставляет: он строит план `plan.json`, по нему пишет скрипт `generate.py`, и тот создает файл LDraw `model.mpd`. Гипотеза автора: агенты лучше пишут Python, порождающий геометрию, чем саму математику поворотов и позиций. Инструменты помогают искать подходящие детали, примеры моделей и подмодели, находить столкновения и зазоры при размещении и рендерить без окна. Для поиска деталей используется семантический поиск `jev-rerank` с ключом `TYPESAFE_API_KEY`, без ключа агент возвращается к полнотекстовому поиску, и модели могут получиться хуже. На выходе исходный текст LDraw, 3D-просмотр, плеер, VR для Meta Quest 3, изображения, файл `.glb` для правки в Blender и история чата с ходом рассуждений агента. Запускается веб-приложение в Docker из двух репозиториев.
Для кого. Любителям LEGO и экспериментаторам с агентами, которые хотят получать из описания редактируемые цифровые модели, и исследователям генерации физических конструкций.
Подходит, если
- Нужна модель LEGO в формате LDraw по описанию, с проверкой столкновений деталей
- Модель надо открыть в Blender: проект выдает файл `.glb` с метаданными в пользовательских свойствах
- Хочется посмотреть, как агент рассуждал при сборке: сохраняется история чата и ход мысли
- Вы изучаете, как агенты справляются с геометрией через генераторы на Python
Не подходит, если
- Нужна дешевая генерация: большие корректные модели сейчас по силам только дорогим топовым моделям
- Нужны минифигурки и животные или хорошие космические корабли: автор сам называет эти семейства слабыми местами
- Сеть небезопасна: у веб-приложения нет входа, и его нельзя открывать в недоверенных сетях
Пример запроса к агенту
Собери модель башенного крана из настоящих деталей LEGO, проверь столкновения и выдай файл для BlenderОграничения
- Первый релиз. Сборка образа Docker занимает долго и требует около 5 ГБ диска, нужны Git и Docker, два репозитория ldraw-nova и ldraw-nova-docker одного тега.
- Без ключа `TYPESAFE_API_KEY` поиск деталей идет полнотекстовым методом и результат хуже.
- VR на Meta Quest 3 работает с проблемами обработки модели и производительности. Генерация медленная.
- У веб-приложения нет входа, запускать его стоит только в доверенных сетях.
Как отключить. Остановите приложение командой `docker compose down` в папке ldraw-nova-docker. Образ и тома Docker удаляются командами Docker, клонированные папки репозиториев удаляются вручную. Ключ `TYPESAFE_API_KEY` хранится в настройках веб-приложения.
Частые вопросы
Что такое LDraw и зачем он агенту?
LDraw — текстовый формат описания моделей из деталей LEGO, язык сборки для 3D CAD. Он простой, низкоуровневый и исполняемый, поэтому агент может порождать его кодом и проверять результат рендерами.
Как запустить ldraw-nova?
Склонируйте `ldraw-nova` и `ldraw-nova-docker` одного тега, в папке `ldraw-nova-docker` выполните `docker compose build` и `docker compose up -d`. Приложение открывается на `https://localhost:8443` (нужно для VR) или на `http://localhost:8765`.
Нужен ли ключ для поиска деталей?
Для лучшего поиска нужен `TYPESAFE_API_KEY` модели Jev System One, его вводят в настройках веб-приложения. Без ключа агент использует полнотекстовый поиск, и модели могут получиться хуже.
Что агент получает на выходе?
Исходный текст LDraw, 3D-просмотр и плеер, VR-режим для Meta Quest 3, изображения, файл `.glb` для правки в Blender с метаданными в пользовательских свойствах, а также историю чата и ход рассуждений агента.
Почему агент строит план и скрипт, прежде чем ставить детали?
По наблюдению автора, агенты лучше пишут Python, который порождает геометрию, чем считают повороты и позиции деталей сами. Поэтому цепочка идет от плана `plan.json` к скрипту `generate.py` и файлу `model.mpd`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ВоркфлоуMCP-сервер генерации 3D: по описанию агент получает модель GLB с именованными частями, суставами и скриптом для Blender
Плагин для Claude Code и Codex: агент строит точные детали в Blender 5.2 через bpy, выгружает glTF и STL и проверяет сетку.
Локальный MCP-сервер и CLI: агент пишет JavaScript для 3D-модели, получает рендеры и проверки, а на выходе GLB и исходник
Скилл scan-to-threejs превращает запись с телефона в код сцены, уточняя модель за несколько проверочных кругов.
Официальный скилл Lovart: агент рисует картинки, делает видео, музыку и 3D-модели и ведет проекты с историей диалогов
Дает текстовым моделям зрение: картинки идут в GLM и Agnes, OCR в Baidu и Windows, PDF в MinerU, ответ приходит в JSON
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ldraw-nova (эта карточка) | нет | 543 | ||
| build123d-mcp | нет | не нужна | 149 | параметрический CAD-код для инженерных деталей, а здесь модели из готовых деталей LEGO в формате LDraw |
| Blender Agent Skills | нет | 1 014 | скиллы для Blender, а здесь модели из каталога деталей LEGO с проверкой столкновений |
Коротко о README
README показывает результат работы, объясняет установку через Docker с оговоркой о ключе поиска деталей и перечисляет открытые вопросы. В разделе об идее автор описывает путь от трех прежних экспериментов к нынешней схеме, затем идут шаги работы агента и таблица руководств.