Supra-3D/SUPRA-Tex

Что это?

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

• 01Создаёт модели в формате GLB с текстурами базового цвета, металличности и шероховатости.
• 02Сохраняет на видимых поверхностях надписи, узоры и границы материалов из исходного изображения.
• 03Заполняет текстурами невидимые области с помощью Interleaved Flow Transformer.
• 04Накладывает текстуры на существующие меши по данным камеры, изображения переднего плана и карт материалов.
• 05Включает локальное веб-приложение на Gradio и скрипты командной строки.
• 06Предлагает дополнительные уточнение текстур и предварительную фильтрацию глубины для границ окклюзии.

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

• Создание текстурированных 3D-объектов или моделей по фотографии товара либо референсу.
• Наложение текстур на существующий меш с готовой геометрией и данными камеры.
• Подготовка PBR-моделей, которым предстоит смена освещения в 3D-движке или рендерере.
• Эксперименты с генерацией 3D-моделей по изображению на одном GPU NVIDIA.

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

1. 1

   Клонируйте репозиторий

   git clone https://github.com/Supra-3D/SUPRA-Tex.git
2. 2

   Установите runtime в активированное окружение Conda (требуются Python 3.10, CUDA 12.4 и nvcc)

   python scripts/install_runtime.py --conda
3. 3

   Войдите в Hugging Face, получите одобрение доступа к DINOv3 и скачайте модели

   python scripts/prepare_models.py
4. 4

   Запустите пример из комплекта, чтобы создать GLB с текстурами

   python scripts/run_example.py --output outputs/spiny_whelk_shell.glb

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

• !Требуется Linux с GPU NVIDIA и набором инструментов CUDA 12.4.
• !Конвейер преобразования изображения в 3D зависит от DINOv3, для доступа к которому требуется одобрение на Hugging Face.
• !Для входных изображений RGB без альфа-канала также нужны RMBG-2 или BiRefNet.

Темы

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

Что такое SUPRA-Tex?

Создаёт текстурированные 3D-модели с поддержкой смены освещения (GLB с картами базового цвета, металличности и шероховатости) по одному изображению, а также накладывает текстуры на существующие меши. SUPRA-Tex превращает одно изображение в 3D-модель с материалами на основе физического рендеринга (PBR). Проект предсказывает материалы на изображении с исходного ракурса, кодирует их в виде привязанных к поверхности 3D-наблюдений и с помощью Interleaved Flow Transformer заполняет области, невидимые камере. Цель — сохранить на видимой поверхности мелкие детали исходного изображения, например надписи, узоры и границы материалов.

SUPRA-Tex можно использовать бесплатно? Какая у него лицензия?

SUPRA-Tex распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

SUPRA-Tex всё ещё поддерживается?

Активно поддерживается. Последний коммит в SUPRA-Tex — 29 окт. 2026 г..

Для чего можно использовать SUPRA-Tex?

Создание текстурированных 3D-объектов или моделей по фотографии товара либо референсу. Наложение текстур на существующий меш с готовой геометрией и данными камеры. Подготовка PBR-моделей, которым предстоит смена освещения в 3D-движке или рендерере. Эксперименты с генерацией 3D-моделей по изображению на одном GPU NVIDIA.

Как установить SUPRA-Tex?

Клонируйте репозиторий: git clone https://github.com/Supra-3D/SUPRA-Tex.git Установите runtime в активированное окружение Conda (требуются Python 3.10, CUDA 12.4 и nvcc): python scripts/install_runtime.py --conda Войдите в Hugging Face, получите одобрение доступа к DINOv3 и скачайте модели: python scripts/prepare_models.py Запустите пример из комплекта, чтобы создать GLB с текстурами: python scripts/run_example.py --output outputs/spiny_whelk_shell.glb

Где скачать SUPRA-Tex?

Исходный код и инструкции по установке — на GitHub: https://github.com/Supra-3D/SUPRA-Tex