ARTDECO: Towards Efficient and High-Fidelity On-the-Fly 3D Reconstruction with Structured Scene Representation
Guanghao Li*, Kerui Ren*, Linning Xu, Zhewen Zheng, Changjian Jiang, Xin Gao, Bo Dai, Jian Pu†, Mulin Yu†, Jiangmiao Pang
📢 News
[2026.02.19] 🚀 Training code is officially released!
[2026.01.26] 🎉 Our paper has been accepted by ICLR 2026.
🏗️ System Architecture
Frontend and Backend Modules

Mapping Module

🛠️ Installation
Environment Setup
Our framework is validated on Python 3.11/3.12, PyTorch 2.3.1/2.7.1, and CUDA 12.1/12.8, generally compatible with recent PyTorch/CUDA releases.
- Clone the repo.
git clone https://github.com/InternRobotics/ARTDECO.git
cd ARTDECO/
- Create the environment and install PyTorch.
# python 3.11 + cuda 12.1 + pytorch 2.5.1
conda create -n artdeco python=3.11
conda activate artdeco
conda install pytorch==2.5.1 torchvision==0.20.1 torchaudio==2.5.1 pytorch-cuda=12.1 -c pytorch -c nvidia
or
# python 3.12 + cuda 12.8 + pytorch 2.7.1
conda create -n artdeco python=3.12
conda activate artdeco
pip install torch==2.7.1 torchvision==0.22.1 torchaudio==2.7.1 --index-url https://download.pytorch.org/whl/cu128
Dependency & Model Preparation
- Download Checkpoints.
Place the required MASt3R and Pi3 Checkpoints in the models/ directory.
# Download MASt3R checkpoints
mkdir -p models/
wget https://download.europe.naverlabs.com/ComputerVision/MASt3R/MASt3R_ViTLarge_BaseDecoder_512_catmlpdpt_metric.pth -P models/
wget https://download.europe.naverlabs.com/ComputerVision/MASt3R/MASt3R_ViTLarge_BaseDecoder_512_catmlpdpt_metric_retrieval_trainingfree.pth -P models/
wget https://download.europe.naverlabs.com/ComputerVision/MASt3R/MASt3R_ViTLarge_BaseDecoder_512_catmlpdpt_metric_retrieval_codebook.pkl -P models/
- Build VSLAM Module.
# Install VSLAM thirdparty
cd VSLAM
pip install -e thirdparty/mast3r --no-build-isolation
pip install -e thirdparty/in3d --no-build-isolation
pip install -e . --no-build-isolation
# Install Pypose and GeoCalib
pip install pypose
python -m pip install -e "git+https://github.com/cvg/GeoCalib#egg=geocalib"
cd ..
- Build Reconstruct Module.
!!! Please use the
diff_gaussian_rasterizationmodule located in the on-the-fly-nvs submodule. Note that this version is intended strictly for optimizing Gaussians, not for rendering.
# Install gsplat
pip install gsplat
# Install submodules
cd Reconstruct
pip install submodules/diff_gaussian_rasterization --no-build-isolation
pip install submodules/fused-ssim --no-build-isolation
pip install submodules/simple-knn --no-build-isolation
pip install submodules/graphdecoviewer
cd ..
- Install the remaining dependencies.
🚀 Quick Start (Training)
We provide the PINGPONG dataset as a benchmark example.
Data Structure
Organize your dataset as follows:
└── pingpong
├── images
│ └── ${timestamp}.png/.jpg
└── (intr.yaml)
The reference intr.yaml is shown below:
width: 2592
height: 1944
# fx, fy, cx, cy ...
calibration: [1478.95393660578, 1478.95393660578, 1296.0, 972.0]
Run Reconstruction
Execute the following command to start the on-the-fly reconstruction:
bash run.sh
✉️ Contact & Citation
For questions, please contact Kerui Ren (renkerui@sjtu.edu.cn).
If you find ARTDECO helpful for your research, please cite our work:
@article{li2025artdeco,
title={Artdeco: Towards efficient and high-fidelity on-the-fly 3d reconstruction with structured scene representation},
author={Li, Guanghao and Ren, Kerui and Xu, Linning and Zheng, Zhewen and Jiang, Changjian and Gao, Xin and Dai, Bo and Pu, Jian and Yu, Mulin and Pang, Jiangmiao},
journal={arXiv preprint arXiv:2510.08551},
year={2025}
}