К содержимому
3D

TRELLIS.2-4B (Lux3D)

генерация 3D-моделей из картинок в одном файле

2 мин чтенияобновлено

Этот репозиторий содержит каноническую сборку весов модели microsoft/TRELLIS.2-4B от oxide-lab, подготовленную для локального запуска в движке Lux3D на языке Rust. Модель превращает обычное изображение в детализированный 3D-меш с текстурами и PBR-атрибутами (данными о материалах и отражении света) в форматах GLB, OBJ или PLY. В основе лежит архитектура O-Voxel (разреженное воксельное представление 3D-геометрии) и энкодер DINOv3 ViT-L/16. В отличие от оригинального релиза Microsoft, разбитого на девять отдельных файлов, здесь все 4265 тензоров объединены без потери точности в единый файл model.safetensors весом 15,07 ГиБ. Сборка пригодится 3D-художникам и разработчикам, которым нужен быстрый офлайн-инференс на видеокартах с 12 ГБ памяти без тяжёлого Python-окружения.

Ключевые особенности

  • Единый файл весов: девять исходных шардов сведены побайтово с сохранением оригинальных типов данных (BF16, F16 и F32) и единым конфигом resolved_config.json.
  • Два режима детализации: поддерживается быстрый пайплайн 512 (только геометрия или с текстурой) и каскад 1024_cascade, последовательно уточняющий форму и текстуры.
  • Кроссплатформенные бэкенды: рантайм Lux3D проверен на CPU, CUDA, Vulkan и WGPU с идентичной геометрией на выходе.
  • Умеренный аппетит к памяти: благодаря последовательной загрузке стадий полный текстурированный каскад 1024_cascade умещается в видеокарту уровня RTX 3060 12 ГиБ с запасом около 4 ГиБ.

Что можно сделать

  • Создать готовый ассет для движка: прогнать картинку через каскад 1024_cascade и получить GLB-модель с PBR-цветами вершин для Blender, Unity или Unreal Engine.
  • Быстро набросать болванку: запустить режим --pipeline-type 512 --texture false и за полминуты получить черновую геометрию в OBJ для дальнейшего скульптинга.
  • Встроить 3D-генерацию в сервис: поднять локальный HTTP-сервер Lux3D с автообнаружением модели удаления фона RMBG-2.0.

Пример

cargo run -p lux3d-cli --features cuda -- run trellis2 `
  --model-path  `
  --rmbg-model-path  `
  --source  `
  --output 
ПодробнееВес файла: 15,07 ГиБ (4265 тензоров, общие параметры сборки — 7,79B).
Железо: полный текстурированный прогон 1024_cascade (12 шагов) на RTX 3060 12 ГиБ занимает 438 сек, пик VRAM — ~7,8 ГиБ (выход: 645 960 вершин / 636 302 полигона).
Ограничения: для RGB-картинок без альфа-канала отдельно требуется модель RMBG-2.0 (лицензия CC-BY-NC-4.0); UV-развёртка атласов, заполнение дыр и Metal пока не поддерживаются.
Обсудить Telegram 0 6

Запустится ли?

Запустится в BF16

Влезает без сжатия.

  • BF16веса 15 GB · готовые файлы17 GB
  • FP8 / INT8рекомендуемвеса 7.3 GB8.5 GB
  • 4-bitвеса 4.1 GB5.0 GB

Совет: берите 8-bit.FP8 / INT8 почти не отличается по качеству от полной точности (разница в пределах процента), а памяти занимает вдвое меньше и на RTX 40/50, H100 работает быстрее. Полную точность есть смысл брать только для дообучения.

Что взять под эту модель

Massed ComputeОткрыть Massed Compute

Своя видеокарта: FP8 / INT8 — от RTX 3080 · BF16 — от RTX 4090

Почасовые цены Massed Compute на ноябрь 2026. Цена со скидкой — с промокодом при оплате.

Оценка: веса плюс рабочая память. Длинные ролики, высокое разрешение и большой контекст требуют больше.

Запуск на Massed Compute

Скрипт скачает модель на арендованную машину. Как её запустить — в карточке модели.

  1. 1. Арендуйте машину с подходящей видеокартой

    Открыть Massed Compute
  2. 2. Вставьте скрипт в терминал машины

    Подключитесь по SSH (команда есть в панели Massed Compute) или откройте терминал на рабочем столе машины.

    HF_TOKEN / CIVITAI_TOKENВ начале скрипта строки для токенов: вставьте свой между кавычками. Токен Hugging Face нужен для закрытых моделей, токен Civitai — для моделей с Civitai.

    # oxide-lab/TRELLIS.2-4B
    mkdir -p ~/models
    curl -LsSf https://astral.sh/uv/install.sh | sh
    source "$HOME/.local/bin/env"
    uv tool install "huggingface_hub[cli]"
    hf download oxide-lab/TRELLIS.2-4B --local-dir ~/models/TRELLIS.2-4B
    # Модель в папке ~/models. Как её запускать, написано в карточке модели (ссылка выше).
    Добавить ещё LoRA к TRELLIS.2-4B
  3. 3. Пользуйтесь

    Модель в папке ~/models. Как её запускать, написано в карточке модели (ссылка выше).

Не забудьте остановить машину в панели, когда закончите: оплата идёт поминутно, пока она включена.

Как ускорить

Подобрано под тип модели. Выберите своё железо в блоке выше — покажем то, что подходит именно вам.

  • FlashAttention 44.0.0b40от 18 ноября 2026новая версия

    самое быстрое точное внимание на B200

    Ядра для Blackwell (пока бета). Точное внимание без квантования — подходит для всего, включая LLM.

    Как включить: pip install flash-attn-4; vLLM и SGLang подхватывают сами.

    Предыдущие поколения (2)
    • FlashAttention 3 — Версия для Hopper (H100/H200) с FP8.
    • FlashAttention 2 — Стандарт для RTX 30/40/50 и A100: точное внимание без лишней памяти на длинных контекстах.
  • torch.compile2.15.0от 28 октября 2026новая версия

    10–30% бесплатно

    Компилирует модель под вашу видеокарту. Первый запуск дольше, дальше быстрее.

    Как включить: model = torch.compile(model); в ComfyUI — узел TorchCompileModel.

Семья модели

Дообучение модели

microsoft/TRELLIS.2-4B

Новые посты про версии TRELLIS.2-4B — сжатые, дообучения, LoRA — появятся в колокольчике.

Сжатые версии 5Все на Hugging Face
Дообучения 9Все на Hugging Face
LoRA и адаптеры 9Все на Hugging Face

О модели

oxide-lab/TRELLIS.2-4B
Автор
oxide-lab
Категория
3D
Дата выхода
На сайте

На сайте

Hugging Face

60

Спросить нейросеть об этой модели

Отвечает Gemini 4 · переписка хранится только в этой вкладке

Комментарии

3D

Eco3R

Eco3R