Sat3DGen / README.md
qian43's picture
Update README.md
6a2ff89 verified
---
title: Sat3DGen
emoji: πŸ›°οΈ
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: "5.29.0"
python_version: "3.10"
app_file: app.py
pinned: false
license: mit
models:
- qian43/Sat3DGen
suggested_hardware: t4-small
---
## Sat3DGen – Street-Level 3D Scene Generation from Satellite Images
**[ICLR 2026]** Generate street-level 3D scenes from a single satellite image.
- πŸ“„ [Paper (OpenReview)](https://openreview.net/forum?id=E7JzkZCofa)
- 🌐 [Project Page](https://qianmingduowan.github.io/Sat3DGen_project_page/)
- πŸ’» [GitHub](https://github.com/qianmingduowan/Sat3DGen)
- πŸ€— [Model](https://huggingface.co/qian43/Sat3DGen)
- [Arxiv](arxiv.org/abs/2605.14984)
### Features
- **3D Mesh Generation**: Upload a satellite image β†’ get a downloadable `.obj` mesh with in-browser 3D preview.
- **Video Rendering**: Select a satellite image and sky panorama β†’ render a walkthrough video along a trajectory.
### Usage
Upload a satellite image or select one from the examples, then click "Generate".
The model weights are loaded automatically from HuggingFace.
### Input Requirements
The satellite image should be at **zoom level 20** (same as the [VIGOR](https://github.com/Jeff-Zilence/VIGOR) dataset), resized to **512Γ—512** pixels. You can download satellite tiles at this zoom level from any map tile API (e.g. Google Maps, Bing Maps, Mapbox).
> **Note**: GPU hardware is recommended for reasonable inference speed.