MCPcopy Index your code
hub / github.com/TencentARC/FreeSplatter

github.com/TencentARC/FreeSplatter @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
1,794 symbols 3,863 edges 48 files 191 documented · 11%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

FreeSplatter: Pose-free Gaussian Splatting for Sparse-view 3D Reconstruction

Project Page arXiv

ICCV 2025


This repo is the official implementation of FreeSplatter, a feed-forward framework capable of generating high-quality 3D Gaussians from uncalibrated sparse-view images and recovering their camera parameters in mere seconds.

https://github.com/user-attachments/assets/0c73b693-9428-46bd-843c-132434b9686f

⚙️ Installation

We recommend using Python>=3.10, PyTorch>=2.1.0, and CUDA>=12.1.

conda create --name freesplatter python=3.10
conda activate freesplatter
pip install -U pip

# Install PyTorch and xformers
# You may need to install another xformers version if you use a different PyTorch version
pip install torch==2.4.0 torchvision==0.19.0 --index-url https://download.pytorch.org/whl/cu121
pip install xformers==0.0.27.post2

# Install other requirements
pip install -r requirements.txt

🤖 Pretrained Models

We provide the following pretrained models:

Model Description #Params Download
FreeSplatter-O Object-level reconstruction model 306M Download
FreeSplatter-O-2dgs Object-level reconstruction model using 2DGS (finetuned from FreeSplatter-O) 306M Download
FreeSplatter-S Scene-level reconstruction model 306M Download

💫 Inference

We recommand to start a gradio demo in your local machine, simply run:

python app.py

⚖️ License

FreeSplatter's code and models are licensed under the Apache 2.0 License with additional restrictions to comply with Tencent's open-source policies. Besides, the libraries Hunyuan3D-1 and BRIAAI RMBG-2.0 have their own non-commercial licenses.

:books: Citation

If you find our work useful for your research or applications, please cite using this BibTeX:

@article{xu2024freesplatter,
  title={FreeSplatter: Pose-free Gaussian Splatting for Sparse-view 3D Reconstruction},
  author={Xu, Jiale and Gao, Shenghua and Shan, Ying},
  journal={arXiv preprint arXiv:2412.09573},
  year={2024}
}

Core symbols most depended-on inside this repo

n
called by 212
freesplatter/webui/gradio_customgs/templates/component/Index-f5583db3.js
n
called by 205
freesplatter/webui/gradio_custommodel3d/templates/component/Index-0bb1de05.js
H
called by 46
freesplatter/webui/gradio_custommodel3d/templates/component/wrapper-6f348d45-f837cf34.js
to
called by 45
freesplatter/models/renderer/gaussian_utils.py
p
called by 42
freesplatter/webui/gradio_customgs/templates/component/Canvas3DGS-0fbc0d9a.js
p
called by 41
freesplatter/webui/gradio_custommodel3d/templates/component/Canvas3DGS-f5539f54.js
O
called by 41
freesplatter/webui/gradio_customgs/templates/component/Canvas3DGS-0fbc0d9a.js
error
called by 40
freesplatter/webui/gradio_custommodel3d/templates/component/wrapper-6f348d45-f837cf34.js

Shape

Function 907
Method 638
Class 249

Languages

TypeScript88%
Python12%

Modules by API surface

freesplatter/webui/gradio_customgs/templates/component/Index-f5583db3.js369 symbols
freesplatter/webui/gradio_custommodel3d/templates/component/Index-0bb1de05.js367 symbols
freesplatter/webui/gradio_customgs/templates/component/Canvas3DGS-0fbc0d9a.js282 symbols
freesplatter/webui/gradio_custommodel3d/templates/component/Canvas3DGS-f5539f54.js269 symbols
freesplatter/webui/gradio_custommodel3d/templates/component/wrapper-6f348d45-f837cf34.js140 symbols
freesplatter/webui/gradio_customgs/templates/component/wrapper-6f348d45-19fa94bf.js140 symbols
freesplatter/hunyuan/hunyuan3d_mvd_std_pipeline.py26 symbols
freesplatter/models/renderer_2dgs/gaussian_utils.py25 symbols
freesplatter/models/renderer/gaussian_utils.py23 symbols
freesplatter/webui/shared_opts.py14 symbols
freesplatter/utils/recon_util.py14 symbols
freesplatter/models/transformer.py13 symbols

For agents

$ claude mcp add FreeSplatter \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact