Mira-Scene README

The project's README from github.com/VAST-AI-Research/Mira-Scene. As one markdown file: README.md.

Mira-Scene: Pixel-Aligned Layouts for Generative 3D Scene Reconstruction

📄 Paper | 🌐 Project Page

Mira-Scene reconstructs an editable 3D scene from a single image. The pipeline combines interactive instance segmentation, depth estimation, canonical coordinate and voxel prediction, object mesh generation, scene assembly, and environment-map generation.

Mira-Scene teaser

📰 News

🔥 Mira-Scene is fully open-source

The Mira-Scene inference pipeline, Mira-CCM, UniDataset, evaluation and visualization tools, example cases, and both the Stage 1 pretrained checkpoint and Stage 2 final checkpoint are publicly available in this repository and through Hugging Face.

✅ Finetuning data is now available

The released Scene data and outpainted Objaverse data are available from the Mira-Scene Dataset repository. The large Objaverse rendering data used for pretraining is not included; it can be generated conveniently from the source assets.

Inference

The stage-wise pipeline supports resumable execution, multiple depth and mesh backends, and case-level multi-GPU sharding. See the inference guide (中文).

Visualization

See the visualization guide (中文).

Evaluation

See the evaluation guide (中文).

Method Data Availability 3D Data Scale Data Preparation CD↓ [email protected]↑ EMD↓ 3D-IoU↑ ICP-Rot↓ 2D-IoU↑ ADD-S↓
SAM3D Closed-source Million+ Extensive manual layout annotation 0.027 0.817 0.163 0.520 7.566 0.672 0.078
Ours Open-source 80k Fully automatic pipeline 0.021 0.843 0.169 0.727 5.616 0.783 0.031

Please refer to the evaluation guide for details.

Training

Training is organized into two stages:

  1. Pretraining with example_train/configs/pretrain_l1.yaml;
  2. Finetuning with example_train/configs/finetune.yaml.

A pretrained Mira-CCM checkpoint is available from Hugging Face and can be used directly for the second-stage finetuning.

See the training guide for installation, configuration, checkpoint download, and launch instructions.

Citation

@article{sun2026mira,
  title={Mira-Scene: Pixel-Aligned Layouts for Generative 3D Scene Reconstruction},
  author={Sun Yang-Tian and Liu Tianjia and Huang Zehuan and Huang Yi-Hua and Lyu Xiaoyang and Yang Ziyi and Zou Zi-Xin and Guo Yuan-Chen and Cao Yan-Pei and Qi Xiaojuan},
  journal={arXiv preprint arXiv:2609.23796},
  year={2026}
}

License

The Mira-Scene code in this repository is released under the MIT License. Third-party components, pretrained models, and datasets retain their respective licenses and terms of use.

Mira-Scene (VAST-AI-Research/Mira-Scene)

Searching Database…

Что это?Mira-Scene — это пайплайн, восстанавливающий редактируемую 3D-сцену из одного изображения: он объединяет интерактивную сегментацию объектов, оценку глубины, предсказание канонических координат и вокселей, генерацию мешей объектов, сборку сцены и генерацию карты окружения.
Это готовое приложение или исследовательский пайплайн, который я запускаю сам?Это открытый исследовательский пайплайн, а не упакованное приложение: вы получаете код инференса плюс предобученный чекпоинт Mira-CCM Stage 1 и финальный чекпоинт Stage 2, которые запускаете поэтапно самостоятельно.
Как запустить пайплайн инференса?Следуйте руководству по инференсу и запустите поэтапный пайплайн — он поддерживает возобновляемое выполнение, несколько бэкендов для глубины и мешей и мульти-GPU шардирование на уровне отдельных кейсов.
Нужны ли предобученные чекпоинты и GPU для запуска?Да — нужны предобученный чекпоинт Stage 1 и финальный чекпоинт Stage 2, скачиваемые с Hugging Face, а также GPU-ресурсы, потому что пайплайн шардируется по GPU для каждого кейса.
Все ли обучающие данные включены в релиз?Опубликованные данные Scene и дорисованные (outpainted) данные Objaverse предоставляются для файнтюнинга, но большой массив рендеров Objaverse, использованный для предобучения, не включён — его придётся заново сгенерировать из исходных ассетов.
Это скорее для исследователей, чем для обычных пользователей?Да, он ориентирован на исследователей компьютерного зрения и генеративного 3D, которым нужно сравнивать методы реконструкции сцен на бенчмарках или строить решения поверх них, — для этого в комплекте статья, таблицы бенчмарков и конфиги обучения.
Лицензия MIT покрывает всё содержимое репозитория?Под лицензией MIT распространяется только сам код Mira-Scene; сторонние компоненты, предобученные модели и датасеты сохраняют свои отдельные лицензии и условия.
Что такое Mira-CCM?Mira-CCM — это чекпоинт модели канонических координат, предобученный на этапе Stage 1 пайплайна; он опубликован на Hugging Face и может напрямую использоваться для запуска файнтюнинга Stage 2.
Как Mira-Scene сравнивается с SAM3D?На бенчмарке Mira-Scene набирает больше по 3D-IoU (0.727 против 0.520), 2D-IoU и ADD-S, используя лишь 80 тыс. открытых 3D-примеров с полностью автоматическим пайплайном данных, тогда как SAM3D опирается на закрытый миллион с лишним примеров, требующих масштабной ручной разметки раскладок.
Как организовано обучение?Обучение идёт в два этапа: предобучение с exampletrain/configs/pretrainl1.yaml и файнтюнинг с exampletrain/configs/finetune.yaml; предобученный чекпоинт Mira-CCM с Hugging Face позволяет сразу перейти к этапу файнтюнинга.
Откуда берутся датасеты?Данные Scene и дорисованные данные Objaverse публикуются отдельно в репозитории Mira-Scene Dataset; масштабные сырые рендеры Objaverse, использованные для предобучения, не распространяются и должны быть заново сгенерированы из исходных ассетов.
Size
46.5 MB
Stars
211
Updated
CommitOct 11
Age
27d
Commits · 90 Days